home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 3 / Cream of the Crop 3.iso / comm / mycmm220.zip / MYCOMM.DOC < prev    next >
Text File  |  1994-03-29  |  202KB  |  4,708 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.                                 MyComm  Version 2.20
  10.                          Unregistered Version Documentation
  11.                                Printed March 29, 1994
  12.                       Copyright (c) 1992 - 1994 - Ken Dorshimer
  13.                                  All Rights Reserved
  14.  
  15.  
  16.  
  17.  
  18.             MyComm is NOT Public Domain or free software.  The MyComm
  19.           software, support files, and documentation are Copyright (c) 1992
  20.           - 1994 Ken Dorshimer, all rights reserved.
  21.  
  22.             MyComm is being marketed under the "Shareware" concept.  You
  23.           may use MyComm for a 30 day evaluation period to determine its
  24.           usefulness in your particular application.  After the 30 day
  25.           evaluation period you must register MyComm if you continue to use
  26.           it.
  27.  
  28.             Registration is as follows:
  29.  
  30.               Send $25 (twenty five U.S. dollars drawn on a U.S. bank),
  31.           plus $2 shipping and handling to:
  32.  
  33.                Ken Dorshimer
  34.                P.O. Box 5143
  35.                Belmont, Ca. 94002
  36.  
  37.             (Please send check or money order, do not send cash.  People
  38.           who want to order MyComm from outside the U.S. should obtain a
  39.           money order in U.S. dollars from a local bank.)
  40.  
  41.             For your convenience there is a file called ORDER.FRM which is
  42.           an order form for MyComm.  An order form is also included in
  43.           Appendix F of this documentation.  Please note that if you
  44.           downloaded MyComm from a BBS that charges a subscription fee,
  45.           obtained a copy of MyComm from a "shareware disk copying"
  46.           service, or CD ROM library the registration fee for MyComm is not
  47.           paid for or collected by those services!
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.           1.0  Introduction to MyComm                                1
  56.               1.1  Registration and Licensing                        2
  57.               1.2  Disclaimer and Warranty                           5
  58.               1.3  Definitions, Acronyms                             5
  59.               1.4  General System Requirements                       6
  60.               1.5  MyComm Files                                      7
  61.               1.6  MyComm Support and Technical Assistance           7
  62.           2.0  MyComm Installation                                   8
  63.               2.1  System Requirements                               8
  64.               2.2  MyComm Installation Instructions                  9
  65.               2.3  Running MyComm                                   11
  66.               2.4  Command Line Parameters                          12
  67.                   2.4.1 Join Script                                 12
  68.                   2.4.2 Dial Entries  (Registered version only)     12
  69.                   2.4.3 Timed Start  (Registered version only)      13
  70.           3.0  MyComm Screens and Menus                             13
  71.               3.1  Terminal Screen                                  14
  72.               3.2  Help Menu - F1                                   15
  73.               3.3  Chat Mode - Alt A                                15
  74.               3.4  Send Break - Alt B                               16
  75.               3.5  Clear the Screen - Alt C                         16
  76.               3.6  Dialing Functions - Alt D                        16
  77.                   3.6.1  Add Phone List Item                        17
  78.                   3.6.2  Edit Phone List Item Screen                17
  79.                       3.6.2.1  Name                                 18
  80.                       3.6.2.2  Number                               18
  81.                       3.6.2.3  Baud Rate                            18
  82.                       3.6.2.4  Data Bits                            19
  83.                       3.6.2.5  Data Parity                          19
  84.                       3.6.2.6  Stop Bits                            19
  85.                       3.6.2.7  Default Protocol                     19
  86.                       3.6.2.8  Dial Prefix                          19
  87.                       3.6.2.9  Logon Name                           20
  88.                       3.6.2.10 Password                             20
  89.                       3.6.2.11 Terminal Type                        20
  90.                       3.6.2.12 Local Echo                           21
  91.                       3.6.2.13 Received BS (BackSpace) Destructive  21
  92.                       3.6.2.14 BS Key Sends BS or DELete            21
  93.                       3.6.2.15 Strip Hi Bits                        21
  94.                       3.6.2.16 Add LF after incoming CR             22
  95.                       3.6.2.17 Clear last date called               22
  96.                       3.6.2.18 Script                               22
  97.                       3.6.2.19 Save Changes                         22
  98.                   3.6.3  Delete an Item                             22
  99.                   3.6.4  Call Numbers (Dial)                        22
  100.                   3.6.5  Phone Item Info Screen                     23
  101.                   3.6.6  Manual Dial Screen                         24
  102.                   3.6.7  Mark Phone List Items                      24
  103.                   3.6.8  Find Phone List Items                      25
  104.                   3.6.9  Load Phone List Screen                     25
  105.                   3.6.10 Sort Phone List                            25
  106.                   3.6.11 Move Phone List Item                       25
  107.                   3.6.12 Print Phone List                           26
  108.  
  109.                                          i
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.               3.7  Local Echo On/Off - Alt E                        26
  117.               3.8  Hang Up Modem - Alt H                            26
  118.               3.9  Send Modem Initialization Strings - Alt I        26
  119.               3.10 Join Script - Alt J                              27
  120.               3.11 Present Line Status - Alt L                      27
  121.               3.12 Scroll Back - Alt K                              28
  122.               3.13 Manual Dial - Alt M                              28
  123.               3.14 Outside to DOS - Alt O                           28
  124.               3.14 Change Port Parameters - Alt P                   29
  125.               3.16 Quick Re-Dial - Alt Q                            29
  126.               3.17 Run External Program - Alt R                     29
  127.               3.18 Session Capture On/Off/Pause - Alt S             30
  128.               3.19 Terminal Emulation - Alt T                       30
  129.               3.20 Update Configuration - Alt U                     30
  130.                   3.20.1  Modem Setup Screen                        31
  131.                       3.20.1.1  COM Port                            32
  132.                       3.20.1.2  Modem Initialization String         32
  133.                       3.20.1.3  Modem Attention String              33
  134.                       3.20.1.4  Modem Hang Up String                33
  135.                       3.20.1.5  Modem Answer String                 33
  136.                       3.20.1.6  Modem Cancel Dial String            33
  137.                       3.20.1.7  Modem Dial Suffix String            33
  138.                       3.20.1.8  Dialing Wait Time                   34
  139.                       3.20.1.9  Pause Between Calls                 34
  140.                       3.20.1.10 Local Echo on by Default            34
  141.                       3.20.1.11 Use DTR to Hang Up Modem            34
  142.                       3.20.1.12 Use XON/XOFF Flow Control           35
  143.                       3.20.1.13 Use CTS/RTS Flow Control            35
  144.                       3.20.1.14 Use DSR/DTR Flow Control            35
  145.                       3.20.1.15 Dialing Prefixes                    35
  146.                       3.20.1.16 Connect Strings                     36
  147.                   3.20.2  Paths Setup                               36
  148.                       3.20.2.1  Download Directory                  37
  149.                       3.20.2.2  Upload Directory                    37
  150.                       3.20.2.3  Path\File for Screen Capture        37
  151.                       3.20.2.4  Session Capture Path\File           37
  152.                       3.20.2.5  Phone File Path\File                38
  153.                       3.20.2.6  Editor Path\Filename                38
  154.                       3.20.2.7  External Programs Path\Filename     38
  155.                   3.20.3  Protocols Setup                           38
  156.                       3.20.3.1  ASCII Transfers Setup               38
  157.                           3.20.3.1.1  Strip High Bits               39
  158.                           3.20.3.1.2  Remote Abort Char             39
  159.                           3.20.3.1.3  CR Translation                39
  160.                           3.20.3.1.4  LF Translation                40
  161.                           3.20.3.1.5  Local Echo On During Uploads  40
  162.                           3.20.3.1.6  Expand Blank Lines to Spaces  40
  163.                           3.20.3.1.7  Line Pace Time                40
  164.                           3.20.3.1.8  Character Pace Time           40
  165.                           3.20.3.1.9  Pacing Char                   41
  166.                       3.20.3.2  Zmodem Transfers Setup              41
  167.                       3.20.3.2.1  Zmodem 32 Bit CRC                 41
  168.                       3.20.3.2.2  Zmodem Auto Download Feature      41
  169.                       3.20.3.2.3  Zmodem Send Crash Recovery        41
  170.  
  171.                                          ii
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.                       3.20.3.2.4  Zmodem Receive Crash Recovery     42
  179.                       3.20.3.4  Kermit Transfers Setup              42
  180.                       3.20.3.4  External Protocols Setup            43
  181.                   3.20.4  Miscellaneous Options Setup               44
  182.                       3.20.4.1  Screen Background Color             45
  183.                       3.20.4.2  Screen Text Color                   45
  184.                       3.20.4.3  Date Format Style                   45
  185.                       3.20.4.4  12 or 24 Hour Time Format           45
  186.                       3.20.4.5  Make Noise When Calls Connect       46
  187.                       3.20.4.6  Make Noise After File Transfers     46
  188.                       3.20.4.7  Use Direct Video                    46
  189.                       3.20.4.8  Your Name for sign on               46
  190.                       3.20.4.9  Password for sign on                46
  191.                       3.20.4.10 Clever quip for TagLine             47
  192.                       3.20.4.11 Guess Up/Download Filename          47
  193.                   3.20.5  COM Port Addresses                        47
  194.                   3.20.6  Restore to Defaults                       48
  195.                   3.20.7  Save Setup                                48
  196.               3.21 Send Screen to File - Alt W                      48
  197.               3.22 Exit MyComm - Alt X                              48
  198.               3.23 Help Screen - F1                                 48
  199.               3.24 Send Name - F2                                   49
  200.               3.25 Send Password - F3                               49
  201.               3.26 Send Tagline  - F4                               49
  202.               3.27 Transferring Files                               49
  203.                   3.27.1  Starting a File Transfer                  50
  204.                   3.27.2  File Transfer Hints                       53
  205.                   3.27.3  Download Files - PgDn                     53
  206.                   3.27.4  UpLoad Files - PgUp                       53
  207.                   3.27.5  ASCII File Transfers                      53
  208.                   3.27.6  SEAlink Derived File Transfers            54
  209.                   3.27.7  Xmodem File Transfers                     54
  210.                   3.27.8  1K-Xmodem File Transfers                  54
  211.                   3.27.9  Ymodem Batch File Transfers               55
  212.                   3.27.10  Ymodem-G Batch File Transfers            55
  213.                   3.27.11 Zmodem File Transfers                     55
  214.                   3.27.12 Kermit File Transfers                     56
  215.                   3.27.13 External Protocol File Transfers          56
  216.                   3.27.14 MyComm as a Host                          56
  217.           Appendix A - MyComm Command Summary                       58
  218.           Appendix B - MyComm Line Editing Functions                59
  219.           Appendix C - Terminal Emulation                           60
  220.               TTY Terminal Emulation                                60
  221.               ANSI Terminal Emulation                               60
  222.               VT-52 and VT-100 Terminal Emulation                   61
  223.               3270 Terminal Emulation (Registered version only)     62
  224.           Appendix D - Troubleshooting                              63
  225.           Appendix E - MyComm Script Language                       66
  226.               1.0  Script Language Introduction                     66
  227.               1.2  Creating a Script                                66
  228.           2.0  Script Language                                      67
  229.               2.1  Special Script Characters                        68
  230.               2.2  Script Functions                                 68
  231.                   2.2.1  Labels                                     68
  232.  
  233.                                          iii
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.                   2.2.2  WAITFOR()                                  69
  241.                   2.2.3  XMIT()                                     69
  242.                   2.2.4  GOTO()                                     69
  243.                   2.2.5  SETFLAG()                                  69
  244.                   2.2.6  INCFLAG()                                  70
  245.                   2.2.7  DECFLAG()                                  70
  246.                   2.2.8  IFFLAG()                                   70
  247.                   2.2.9  IFSCAN()                                   70
  248.                   2.2.10 SENDNAME()                                 71
  249.                   2.2.11 SENDPASS()                                 71
  250.                   2.2.12 SENDFILE()                                 71
  251.                   2.2.13 RECVFILE()                                 72
  252.                   2.2.14 SNDBREAK()                                 73
  253.                   2.2.15 ALARM()                                    73
  254.                   2.2.16 PAUSE()                                    73
  255.                   2.2.17 HANGUP()                                   73
  256.                   2.2.18 IGNORECD()                                 73
  257.                   2.2.19 SETSTR()                                   74
  258.                   2.2.20 GOSUB()                                    74
  259.                   2.2.21 RETURN()                                   74
  260.                   2.2.22 EXIT()                                     74
  261.                   2.2.23 QUIT()                                     75
  262.                   2.2.24 COMPSTR()                                  75
  263.                   2.2.25 LOCLECHO()                                 75
  264.                   2.2.26 IF()                                       75
  265.                   2.2.27 PORTGET()                                  76
  266.                   2.2.28 DIAL()                                     76
  267.                   2.2.29 CHDIR()                                    76
  268.                   2.2.30 RUNDOS()                                   76
  269.                   2.2.31 FILEHERE()                                 76
  270.                   2.2.32 JUMPSCP()                                  76
  271.                   2.2.33 CONSGET() and CONSMGET()                   76
  272.                   2.2.34 CONSLOC()                                  76
  273.                   2.2.35 CONSCLR()                                  76
  274.                   2.2.36 CONSMSG()                                  76
  275.                   2.2.37 KBDFLSH()                                  76
  276.                   2.2.38 PORTFLSH()                                 76
  277.                   2.2.39 SESCAP()                                   76
  278.           3.0  Script Syntax Checker                                77
  279.                   4.0  Script Sample                                78
  280.           Appendix F - MyComm Order Form                            79
  281.           Appendix G - MyComm Bug Report Form                       80
  282.           Appendix H - Planned Modifications and Upgrades           81
  283.           Appendix I - MyComm Revision History                      82
  284.           Appendix J - Control Characters                           83
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.                                          iv
  296.  
  297.  
  298.           MyComm Version 2.20 Documentation                    Page 1
  299.  
  300.  
  301.  
  302.  
  303.           1.0  Introduction to MyComm
  304.  
  305.             MyComm is a small, yet powerful, data communications program
  306.           designed to enable users to access public bulletin board systems
  307.           (BBS's) and other telecommunication services.  MyComm is designed
  308.           to run under the PC/MS-DOS operating system using DOS version 3.3
  309.           or higher.  MyComm has a variety of built in file transfer
  310.           protocols including Zmodem, Xmodem, Xmodem-1K, Ymodem Batch,
  311.           Ymodem-G Batch, SEAlink, Kermit, and of course ASCII.  There are
  312.           also slots to install up to six external file transfer protocols.
  313.  
  314.             The driving principle behind MyComm is to provide a reliable,
  315.           powerful, and versatile communications package which is easy to
  316.           use, and small in size.  Great care has been taken to optimize
  317.           MyComm for operating speed and to keep the executable code size
  318.           small so that it takes up less of your valuable disk space.
  319.           MyComm is designed to be easy to use for both novice and
  320.           experienced users, and employs a menu system that is friendly and
  321.           simple to navigate through.
  322.  
  323.           MyComm features include:
  324.  
  325.           ■    A full featured communications package which is small in
  326.                size.
  327.  
  328.           ■    Wide variety of popular file transfer protocols.
  329.  
  330.           ■    Powerful, yet easy to use "script" language.
  331.  
  332.           ■    Small code size which will run with approximately 200K of
  333.                RAM.
  334.  
  335.           ■    Intelligent ANSI character translation which filters out
  336.                potentially harmful ANSI keyboard re-mapping sequences.
  337.  
  338.           ■    Intelligent DOS shell function that brings you back to the
  339.                disk drive and directory that you started from when you
  340.                return to MyComm.
  341.  
  342.           ■    Detection and use of the 16550 UART and FIFO buffers.
  343.  
  344.           ■    Locates program and configuration files no matter what
  345.                directory MyComm is started from (DOS 3.0 or greater).
  346.  
  347.           ■    Support for COM ports 1 through 8.
  348.  
  349.           ■    Simple, and easy to use.  Some may even call it "fun"!
  350.  
  351.  
  352.           MyComm Version 2.20 Documentation                    Page 2
  353.  
  354.  
  355.  
  356.           1.1  Registration and Licensing
  357.  
  358.             MyComm is NOT Public Domain or free software.  The MyComm
  359.           software, support files, and documentation are Copyright (c) 1992
  360.           - 1994 Ken Dorshimer, all rights reserved.
  361.  
  362.             MyComm is being marketed under the "Shareware" concept.  You
  363.           may use MyComm for a 30 day evaluation period to determine its
  364.           usefulness in your particular application.  After the 30 day
  365.           evaluation period you must register MyComm if you decide to
  366.           continue to use it.
  367.  
  368.             Registration is as follows:
  369.  
  370.               Send $25 (twenty five U.S. dollars drawn on a U.S. bank),
  371.           plus $2 shipping and handling to:
  372.  
  373.                Ken Dorshimer
  374.                P.O. Box 5143
  375.                Belmont, Ca. 94002
  376.  
  377.             (Please send check or money order, do not send cash.  People
  378.           who want to order MyComm from outside the U.S. should obtain a
  379.           money order in U.S. dollars from a local bank.)
  380.  
  381.             For your convenience there is a file called ORDER.FRM which is
  382.           an order form for MyComm.  The order form is also included in
  383.           Appendix F of this document.  Please note that if you downloaded
  384.           MyComm from a BBS that charges a subscription fee, obtained a
  385.           copy of MyComm from a "shareware disk copying" service, or CD ROM
  386.           library the registration fee for MyComm is not paid for or
  387.           collected by those services!
  388.  
  389.             MyComm represents many, many hours of work on my part in
  390.           research, design, coding, testing, revisions, enhancements and
  391.           writing the documentation.  Writing a piece of software like
  392.           MyComm is not trivial.  Your registration not only gives me the
  393.           incentive to continue producing and upgrading shareware products
  394.           like this one, but it is the right thing to do.
  395.  
  396.             Let's face it.  $25 is not a lot to spend on a program that
  397.           does everything MyComm does.  Comparable communications packages
  398.           are generally much more expensive.  The Shareware market is an
  399.           "all risk" venture for the author, while the user has everything
  400.           to gain.  Your registration tells me that MyComm was worth
  401.           creating, and that people like it.  I like to know that people
  402.           appreciate the effort I put into a project, don't we all?  Enjoy
  403.           using the MyComm software, and I'm looking forward to hearing
  404.           from you.
  405.  
  406.  
  407.           MyComm Version 2.20 Documentation                    Page 3
  408.  
  409.  
  410.  
  411.             When you register MyComm I will send you the most recent
  412.           version of MyComm and its documentation on floppy disk (standard
  413.           3.5" or 5.25" disk, 3.5" preferred).  At this time I am not
  414.           offering a printed manual in order to keep the cost of the
  415.           software reasonable.  Registered users will also be offered a
  416.           discount on future upgrades.  Please bear in mind that the
  417.           registered versions have the latest revisions and enhancements
  418.           (another registration incentive).
  419.  
  420.           Multiple registrations to the same individual or site will be
  421.           discounted as follows:
  422.  
  423.                1  to 5    copies      -  no discount
  424.                6  to 10   copies      -  5% discount
  425.                11 to 25   copies      - 10% discount
  426.                26 to 50   copies      - 20% discount
  427.                51 to 100  copies      - 30% discount
  428.                over 100 copies        - inquire for quote
  429.  
  430.             Inquiries for site licenses and multiple registrations of
  431.           MyComm should be directed to the above address, or via Compuserve
  432.           (Tm) 73113,3536.  In the case of site licenses and multiple
  433.           registrations a maximum of five (5) diskettes will be sent with
  434.           the order unless otherwise negotiated.
  435.  
  436.             Registered users will be granted license to use the MyComm
  437.           software as they deem fit and within the law.  The registered
  438.           version of MyComm may be duplicated for backup purposes only.
  439.           MyComm is not to be used on more than one computer at a time.
  440.           However registered users may install MyComm on their computer at
  441.           work and their computer at home providing that the two computers
  442.           are not operated simultaneously.
  443.  
  444.             Businesses, corporations, organizations, government agencies,
  445.           or schools who intend to use MyComm on more than one computer at
  446.           a time must contact me for a site license.  The registration of
  447.           an individual copy of MyComm is not to be construed a site
  448.           license (let's be serious).  Feel free to contact me regarding
  449.           multiple registrations and site licenses.
  450.  
  451.  
  452.           MyComm Version 2.20 Documentation                    Page 4
  453.  
  454.  
  455.  
  456.             All users are granted a limited license to make copies of the
  457.           unregistered "shareware" version of MyComm for the purpose of
  458.           allowing others to try it out, and the unregistered version may
  459.           also be uploaded to public bulletin board systems subject to the
  460.           above restrictions as well as the following:
  461.  
  462.                ■    MyComm must be distributed in completely unmodified
  463.                     form, including all support files and documentation.
  464.  
  465.                ■    MyComm may not be included or bundled with any other
  466.                     product for any reason without a license from the
  467.                     author, Ken Dorshimer.
  468.  
  469.                ■    No charge or payment may be levied or accepted for the
  470.                     MyComm software except by the author, Ken Dorshimer.
  471.  
  472.             MyComm may not be sold or distributed through a third party
  473.           (this includes copying services and shareware distribution
  474.           outlets which distribute software for a copying fee) without the
  475.           expressed written permission of the author, Ken Dorshimer.
  476.           Shareware distribution services and bulletin boards which charge
  477.           a fee for software distribution should contact me for written
  478.           permission to distribute MyComm.
  479.  
  480.             The MyComm executable file(s) and documentation, both the
  481.           "registered" and "unregistered" versions are copyrighted material
  482.           and may not be modified or reverse engineered in any manner.  If
  483.           you require modified or customized versions of MyComm for
  484.           whatever reason feel free to contact the author at the address
  485.           above.
  486.  
  487.  
  488.           MyComm Version 2.20 Documentation                    Page 5
  489.  
  490.  
  491.  
  492.           1.2  Disclaimer and Warranty
  493.  
  494.           Disclaimer and Warranty:
  495.  
  496.             MyComm was designed and coded on a best efforts basis in
  497.           accordance with the standard of care usually and reasonably
  498.           expected in the performance of such computer software.
  499.  
  500.             THIS SOFTWARE AND DOCUMENTATION IS PROVIDED "AS IS".  THE
  501.           AUTHOR, KEN DORSHIMER, MAKES NO WARRANTY OF ANY KIND, EITHER
  502.           EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO IMPLIED
  503.           WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE
  504.           OR THE SOFTWARE'S USEFULNESS IN A PARTICULAR APPLICATION.  IN NO
  505.           EVENT SHALL THE AUTHOR, KEN DORSHIMER, BE LIABLE FOR ANY DAMAGES
  506.           (INCLUDING DAMAGES FOR LOSS OF BUSINESS OR PERSONAL PROFITS,
  507.           BUSINESS OR PERSONAL INTERRUPTION, LOSS OF BUSINESS OR PERSONAL
  508.           INFORMATION, OR OTHER PECUNIARY LOSS) ARISING OUT OF THE USE OF
  509.           OR INABILITY TO USE THIS PROGRAM, EVEN IF THE AUTHOR, KEN
  510.           DORSHIMER, HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
  511.           THE USER ASSUMES FULL RESPONSIBILITY AND LIABILITY FOR THE PROPER
  512.           USE OF THE MYCOMM SOFTWARE AND ACCOMPANYING DOCUMENTATION.
  513.  
  514.           <Whew>, glad the legal stuff is out of the way.  If I hadn't
  515.           included that my attorney would have me drawn and quartered.
  516.  
  517.  
  518.           1.3  Definitions, Acronyms, Acknowledgements, and Abbreviations
  519.  
  520.                ■ BBS       -  Bulletin Board System
  521.  
  522.                ■ IBM       -  Trademark, International Business Machines
  523.  
  524.                ■ Hayes     -  Hayes (trademark) compatible modems have
  525.                               become the defacto standard in modem
  526.                               communications. The Hayes command set are
  527.                               modem commands preceded by "AT"
  528.  
  529.                ■ DOS       -  Disk Operating System
  530.  
  531.                ■ MS-DOS    -  Microsoft Disk Operating System, trademark of
  532.                               Microsoft Corporation.
  533.  
  534.                ■ Shareware  - A marketing system where users are allowed to
  535.                               evaluate software before purchase and
  536.                               registration.
  537.  
  538.                ■ XMODEM    -  A file transfer protocol developed by Ward
  539.                               Christensen in the summer of 1977.
  540.  
  541.                ■ YMODEM    -  A file transfer protocol based on XMODEM
  542.                               developed by Chuck Forsberg.
  543.  
  544.  
  545.           MyComm Version 2.20 Documentation                    Page 6
  546.  
  547.  
  548.  
  549.  
  550.                ■ ZMODEM    -  A file transfer protocol developed by Chuck
  551.                               Forsberg/Omen Technology, Inc.
  552.  
  553.                ■ SEAlink   -  A file transfer protocol based on XMODEM
  554.                               developed by System Enhancement Associates,
  555.                               Inc. Copyright 1986, 1987 by System
  556.                               Enhancement Associates, Inc.
  557.  
  558.                ■ Kermit    -  A file transfer protocol developed by
  559.                               Columbia University, New York, NY.
  560.  
  561.                ■ WordStar  -  Trademark (company unknown) of an editor
  562.                               which has been around since the early days of
  563.                               personal computers.
  564.  
  565.                ■ Unix      -  Trademark of operating system designed by
  566.                               Bell Labs/Western Electric.
  567.  
  568.                ■ VT-nnn    -  As in VT-52, VT-100, etc. are trademarks of
  569.                               the Digital Equipment Corporation.
  570.  
  571.                ■ 3270      -  3270 and 7171 are designations used by IBM
  572.                               for terminal emulation and protocol
  573.                               conversion respectively.
  574.  
  575.             Any other names, trademarks, etc. not mentioned here belong to
  576.           whomever they belong to.  If there are errors or omissions, and
  577.           you let me know, I will make an effort to correct them in the
  578.           next version of this documentation.
  579.  
  580.  
  581.           1.4  General System Requirements
  582.  
  583.             MyComm is designed to run under the PC/MS-DOS operating system.
  584.           MyComm may be run either from a hard drive or a floppy drive,
  585.           although a floppy drive is not recommended when performing file
  586.           transfers (just too slow).  Great care has been taken to keep the
  587.           code size small so MyComm will run with as little as 200K of main
  588.           memory (RAM) available.  MyComm will run using a Monochrome
  589.           Graphics Adapter (MGA), a true Hercules (Tm) monochrome card,
  590.           EGA, and VGA.
  591.  
  592.             MyComm is designed to use modems which use the Hayes (Tm) "AT"
  593.           command set.  Your modem should support this standard or a subset
  594.           of it.  MyComm supports modem speeds of 300, 1200, 2400, 4800,
  595.           9600, 19200, 38400, 57600, and 115200 baud and a wide variety of
  596.           data bit, parity bit, and stop bit settings.
  597.  
  598.  
  599.           MyComm Version 2.20 Documentation                    Page 7
  600.  
  601.  
  602.  
  603.           1.5  MyComm Files
  604.  
  605.             The files included in the MyComm package are:
  606.  
  607.                ■ MYCOMM.EXE  -     MyComm main executable program.
  608.  
  609.                ■ MYCOMM.DOC  -     Documentation for MyComm (you're reading
  610.                                    it now).
  611.  
  612.                ■ ORDER.FRM   -     Order form for MyComm.
  613.  
  614.                ■ BUGRPT.FRM  -     Form to describe any problems or
  615.                                    bugs you may have found, or to make
  616.                                    suggestions for future versions of
  617.                                    MyComm.
  618.  
  619.                ■ SCP_CHK.EXE -     Program to check the syntax of script
  620.                                    file commands. See Appendix-E "MyComm
  621.                                    Script Language" for more information.
  622.  
  623.                ■ *.SCP       -     Example MyComm "script" language files.
  624.  
  625.             MyComm also creates and modifies the following files as part of
  626.           its normal operation:
  627.  
  628.                ■ MYCOMM.CFG   -    MyComm configuration file.
  629.  
  630.                ■ MYCOMM.PHN   -    MyComm phone list file.
  631.  
  632.                ■ MYCOMM.OLD   -    Backup of the MyComm phone list file.
  633.  
  634.                ■ MYCOMM.SCR   -    File created when you capture the screen
  635.                                    to a file (see Alt W).
  636.  
  637.                ■ MYCOMM.SES   -    File created when capturing your current
  638.                                    session to a file (see Alt S).
  639.  
  640.                ■ Other Files  -    phone lists that you create, script
  641.                                    files, and any files that were
  642.                                    downloaded.
  643.  
  644.           1.6  MyComm Support and Technical Assistance
  645.  
  646.             MyComm technical assistance is offered in the following ways:
  647.  
  648.           ■    Contact the author through Compuserve at 73113,3536
  649.                (preferred method)
  650.  
  651.           ■    Write to:
  652.                P.O. Box 5143
  653.                Belmont, Ca. 94002
  654.  
  655.  
  656.           MyComm Version 2.20 Documentation                    Page 8
  657.  
  658.  
  659.  
  660.  
  661.  
  662.           2.0  MyComm Installation
  663.  
  664.             MyComm is amazingly simple to install and use.  That's the
  665.           whole idea!  The instructions in this section will have you up
  666.           and running in no time.  Pay special attention to the information
  667.           that should be in your CONFIG.SYS file, and the stuff about the
  668.           COM ports.
  669.  
  670.  
  671.           2.1  System Requirements
  672.  
  673.             MyComm is designed to run on IBM or compatible personal
  674.           computers under the MS-DOS operating system.  Machines may be of
  675.           the PC, XT, AT, 386 or above class of personal computers.
  676.  
  677.             MyComm has the following system requirements:
  678.  
  679.                 ■   at least 200K of free memory (RAM).
  680.  
  681.                 ■   MS-DOS version 3.0 or greater or similar "after market"
  682.                     Disk Operating System.
  683.  
  684.                 ■   Hayes compatible modem which accepts the " AT " command
  685.                     set.
  686.  
  687.                 ■   Your CONFIG.SYS file should contain the statements:
  688.  
  689.                          Device=ANSI.SYS
  690.                          Files=40
  691.                          Buffers=40
  692.                     
  693.                     If your CONFIG.SYS file does not contain these
  694.                     statements then you will need to modify the CONFIG.SYS
  695.                     file.  The CONFIG.SYS file may be edited with an
  696.                     ordinary text editor.  Simply type in a line that reads
  697.                     "Device=ANSI.SYS", "Files=40", and one that reads
  698.                     "Buffers=40" (without the quotes) and save the file.
  699.                     Refer to your DOS manual if you need more information
  700.                     on CONFIG.SYS.
  701.  
  702.  
  703.           MyComm Version 2.20 Documentation                    Page 9
  704.  
  705.  
  706.  
  707.           2.2  MyComm Installation Instructions
  708.  
  709.             Before you start the MyComm installation you should know which
  710.           COM port your modem is set for.  Consult your modem manual if
  711.           you're not sure.  Modems vary too much from one manufacturer to
  712.           another to describe every difference in this manual.
  713.  
  714.           Step 1:   Modify your CONFIG.SYS file to make any of the required
  715.                     changes described in section 2.1 above.
  716.  
  717.           Step 2:   Create a directory on your hard drive (or a floppy
  718.                     drive) called "MYCOMM" and change directory into the
  719.                     new "MYCOMM" directory.
  720.  
  721.                                Example:
  722.  
  723.                                    C:
  724.                                    CD\
  725.                                    MD MYCOMM
  726.                                    CD MYCOMM
  727.  
  728.           Step 3:   Copy the MYCOMM files into this new directory.
  729.  
  730.           Step 4:   Run MyComm.  At the DOS command prompt type "MYCOMM"
  731.                     then press the <Enter> key.
  732.  
  733.           Step 5:   MyComm will start to load.  The first time MyComm is
  734.                     run it will tell you that it can't find the
  735.                     "Configuration File".  It will then create a new
  736.                     configuration file called MYCOMM.CFG.  MyComm will also
  737.                     create an empty phone dialing list called MYCOMM.PHN.
  738.  
  739.           Step 6:   MyComm has a default COM port setting of COM Port 1.
  740.                     If your modem is set up for COM 1 already, don't sweat
  741.                     it.  Otherwise, MyComm will prompt you for the serial
  742.                     port to use.  Choose the COM Port that your modem is
  743.                     set on.  MyComm will then try to initialize the COM
  744.                     Port.  If all goes well you should see the letters "OK"
  745.                     on the screen under the copyright notice.  If the modem
  746.                     doesn't appear to be responding, try repeating Step 6
  747.                     using another COM Port (if you have more than one) or
  748.                     see Appendix D "Troubleshooting".
  749.                       You can see if the modem is responding correctly by
  750.                     typing "AT" (without the quotes) and then press
  751.                     <Enter>.  The modem should respond with "OK".  You may
  752.                     test the phone line connection by typing "ATM1DT"
  753.                     (again, without the quotes) then press <Enter>.  This
  754.                     command tells the modem to turn its' speaker on, then
  755.                     dial nothing.  You should hear a dial tone from the
  756.                     modem speaker.  Press <Enter> again and the dial tone
  757.  
  758.  
  759.           MyComm Version 2.20 Documentation                    Page 10
  760.  
  761.  
  762.  
  763.                     should stop and the modem should respond with "NO
  764.                     CARRIER".
  765.  
  766.            Step 7:  Press the <Alt> and "U" key.  This will bring up
  767.                     MyComm's Update Configuration Menu.  Go through each of
  768.                     the menu options and make any changes required.  The
  769.                     remainder of this documentation describes each of the
  770.                     MyComm options and functions.
  771.  
  772.            Step 8:  You will also need to modify the "Modem Initialization
  773.                     String".  This is done in the "Modem Setup" screen.
  774.                     MyComm needs to see text response codes from the modem
  775.                     rather than numeric codes.  The general purpose
  776.                     initialization string that MyComm uses as by default
  777.                     is:
  778.  
  779.                          AT M1 X4 Q0 V1 S0=0 S11=50 S7=50 &C1 &D2^M
  780.  
  781.                     Broken down this means:
  782.  
  783.                     AT     - "Hi modem! I'm sending you commands now".
  784.                     M1     - Turn on modem speaker (M0 turns it off).
  785.                     X4     - Select highest level of responses.
  786.                     Q0     - Always send responses.
  787.                     V1     - Send text responses.
  788.                     S0=0   - Do not answer the phone.
  789.                     S11=50 - Use fast dialing speed.
  790.                     S7=50  - Wait time for Carrier Detect in seconds.
  791.                     &C1    - Keep Carrier Detect (CD) low until a
  792.                              connection is made.
  793.                     &D2    - Use RTS/CTS flow control (important on
  794.                              high speed modems).
  795.                     ^M     - Send Carriage Return character (MyComm
  796.                              internal command - see also Appendix J).
  797.  
  798.  
  799.           MyComm Version 2.20 Documentation                    Page 11
  800.  
  801.  
  802.  
  803.           2.3  Running MyComm
  804.  
  805.             Section 3 of this document covers all the options and functions
  806.           that MyComm offers.  There are some additional items that should
  807.           be covered first.
  808.  
  809.             MyComm may be started in a number of ways.  Below are three
  810.           different methods to start the MyComm program.
  811.  
  812.           Method 1: Start MyComm from the directory that you installed
  813.                     MyComm in. For example:
  814.  
  815.                          CD\MYCOMM
  816.  
  817.                     then type "MYCOMM" and press the <Enter> key.  This
  818.                     will start the MyComm program.
  819.  
  820.           Method 2: MyComm will also load from any directory if you have
  821.                     set a "Path" with the DOS path command that points to
  822.                     the directory MyComm lives in.  For example to set the
  823.                     path type:
  824.  
  825.                          PATH=C:\MYCOMM
  826.  
  827.                     providing of course that you installed MyComm in the
  828.                     directory C:\MYCOMM.  Just substitute the appropriate
  829.                     path in that case.
  830.  
  831.           Method 3: You may also specify the "fully qualified" DOS path to
  832.                     start MyComm.  For example:
  833.  
  834.                         C:\MYCOMM\MYCOMM
  835.  
  836.                    will also cause MyComm to start.
  837.  
  838.             If you have questions about the DOS Path commands or statements
  839.           please refer to your DOS manual.
  840.  
  841.             If you are using DOS version 3.0 or higher MyComm will
  842.           automatically find it's configuration file.  This means that
  843.           MyComm may be started from any drive or directory on your system
  844.           without having to always start in the MyComm directory  This will
  845.           save you the trouble (and typing) of changing directories when
  846.           you want to use MyComm.
  847.  
  848.             MyComm will however try to start a new phone file in the
  849.           directory you are in unless you have included the fully qualified
  850.           path to the phone directory file in the Setup options.  This
  851.           allows you to keep multiple phone files in different directories
  852.           depending on your needs.
  853.  
  854.  
  855.           MyComm Version 2.20 Documentation                    Page 12
  856.  
  857.  
  858.  
  859.           2.4  Command Line Parameters
  860.  
  861.             MyComm will take several "command line" parameters.  Command
  862.           line parameters are commands that are typed after the program
  863.           name at the DOS prompt. For example typing
  864.  
  865.                MYCOMM -J MYSCRIPT.SCP
  866.  
  867.           on the command line will cause MyComm to start then to
  868.           immediately (after initial logo screen) "join" the script
  869.           MYCSCRIPT.SCP.  A description of the command line parameters that
  870.           MyComm understands follows.
  871.  
  872.           :2.4.1 Join Script
  873.  
  874.             The -J <script name> parameter causes MyComm to start the named
  875.           script immediately after MyComm starts up.  See the section "Join
  876.           Script" for more details on MyComm script functions.  Please note
  877.           that the "Join Script" function takes precedence over the "Dial"
  878.           command described below.
  879.  
  880.  
  881.           :2.4.2 Dial Entries  (Registered version only)
  882.  
  883.             The -D <n1, n2, ... nx> function tells MyComm to mark the
  884.           dialing entries that correspond to the numbers after the -D and
  885.           begin dialing them.  This would be the same as if you had gone
  886.           into the dialing directory and manually marked number for dialing
  887.           then started the Call command.  For example
  888.  
  889.                MYCOMM -D 2 4 14 15
  890.  
  891.           will mark dialing entries 2, 4, 14, and 15 and then begin to call
  892.           those entries after MyComm initializes.  Please note that entries
  893.           are separated by a space.  If the dialing entry is invalid it is
  894.           ignored.
  895.  
  896.  
  897.           MyComm Version 2.20 Documentation                    Page 13
  898.  
  899.  
  900.  
  901.           :2.4.3 Timed Start  (Registered version only)
  902.  
  903.             The -T <HH:MM> function starts a timer that waits until the
  904.           specified time before MyComm begins to do anything else.  The
  905.           time may be entered as follows:
  906.  
  907.                 2:00          2:00 Am
  908.                14:00          2:00 Pm  (military time)
  909.                 2:00P         2:00 Pm
  910.  
  911.           For example
  912.  
  913.                MYCOMM -T 6:00P
  914.  
  915.           would tell MyComm that you want to wait until 6:00 Pm before it
  916.           does something.  This is especially useful for setting a timer
  917.           for the -J or -D commands (described above).  While MyComm is
  918.           waiting for the start time a message box is displayed.  You may
  919.           quit the timer by pressing the <ESC> key.
  920.  
  921.  
  922.           3.0  MyComm Screens and Menus
  923.  
  924.             MyComm has several screens and menus to allow you to change
  925.           various options and to perform various functions.  Most screens
  926.           and menus are brought up by pressing the <ALT> key and then a
  927.           letter.  Pressing <F1> while in the terminal screen shows you
  928.           Help Menu which lists all of the MyComm functions (see also
  929.           section 3.2).
  930.  
  931.  
  932.           MyComm Version 2.20 Documentation                    Page 14
  933.  
  934.  
  935.  
  936.           3.1  Terminal Screen
  937.  
  938.             When MyComm is first loaded, and after the configuration file
  939.           has been read, it defaults to the terminal screen which looks
  940.           like this:
  941.  
  942.  
  943.           MyComm <Version Information>
  944.           Copyright (c) 1992 - 1994 Ken Dorshimer  -  All rights reserved.
  945.  
  946.           Press <F1> for Help
  947.           Press <Alt-D> for Dial Screen
  948.  
  949.  
  950.             You will see the version number, and copyright notice.
  951.  
  952.             In the terminal screen you may enter regular Hayes - AT modem
  953.           commands, or choose one of the many MyComm functions.  The MyComm
  954.           functions are listed in the Help Menu which is displayed when you
  955.           press the <F1> key on your keyboard.  The MyComm functions are
  956.           described in more detail in the following sections of this
  957.           manual.
  958.  
  959.  
  960.           MyComm Version 2.20 Documentation                    Page 15
  961.  
  962.  
  963.  
  964.           3.2  Help Menu - F1
  965.  
  966.             Pressing the <F1> key brings up the MyComm Help Screen which
  967.           looks like this:
  968.  
  969.           (NOTE: many of the MyComm screens shown in this documentation are
  970.           smaller than actual size so that they will fit on a printed
  971.           page.)
  972.  
  973.           +------------------------------------------------| MyComm Help |+
  974.           |                                                               |
  975.           |                     MyComm Commands                           |
  976.           |                                                               |
  977.           |Alt A  Activate Chat Mode         Alt M  Manual Dial           |
  978.           |Alt B  Send Break                 Alt O  Outside to DOS        |
  979.           |Alt C  Clear the Screen           Alt P  Change Port Parameters|
  980.           |Alt D  Dialing Functions          Alt Q  Quick Re-Dial         |
  981.           |Alt E  Toggle Local Echo On/Off   Alt R  Run External Program  |
  982.           |Alt H  Hang up modem              Alt S  Session Capture On/Off|
  983.           |Alt I  Send Modem Init. String    Alt T  Terminal Emulation    |
  984.           |Alt K  Scroll BacK                Alt U  Update Configuration  |
  985.           |Alt L  Current Line Status        Alt W  Write Screen to File  |
  986.           |Alt J  Join Script                Alt X  EXit MyComm           |
  987.           |                                                               |
  988.           |                                                               |
  989.           |F1     Help With Commands         PgDn   Download Files        |
  990.           |F2     Send Name                  PgUp   Upload Files          |
  991.           |F3     Send Password                                           |
  992.           |F4     Send Tagline                                            |
  993.           |                                                               |
  994.           |                                                               |
  995.           |  MyComm <Version Information>                                 |
  996.           | Copyright (c) 1992 - 1994 Ken Dorshimer - All rights reserved.|
  997.           |                                                               |
  998.           +---------------------------------------------------------------+
  999.  
  1000.             Pressing <Esc> or any other key closes the MyComm Help Screen
  1001.           window.
  1002.  
  1003.  
  1004.           3.3  Chat Mode - Alt A
  1005.  
  1006.             Pressing the <ALT> and the "A" key brings you into the MyComm
  1007.           Chat window.  The chat screen is useful when you want to send
  1008.           text messages or "chat" interactively with someone while on-line.
  1009.           If you were not using the Chat Mode the "conversation" would
  1010.           eventually end up looking like a garbled mess on your screen.
  1011.  
  1012.             The Chat window is divided horizontally.  The top half of the
  1013.           screen is where received characters are written, the bottom half
  1014.           is where the characters you type are written.
  1015.  
  1016.  
  1017.           MyComm Version 2.20 Documentation                    Page 16
  1018.  
  1019.  
  1020.  
  1021.  
  1022.             To exit Chat Mode, press the <Esc> key.
  1023.  
  1024.           Please note: Some BBS "chat" systems send special control
  1025.           characters to emulate a split screen chat or colors.  Since there
  1026.           is no filtering done by MyComm while in Chat Mode this may cause
  1027.           strange looking characters in your receive window.  If this
  1028.           occurs, exit from Chat Mode and allow the BBS software to control
  1029.           the chat session.
  1030.  
  1031.           3.4  Send Break - Alt B
  1032.  
  1033.             Pressing the <ALT> and the "B" key sends a special modem signal
  1034.           called "BREAK".  Some host systems use the Break signal to
  1035.           perform special functions such as ending a session.
  1036.  
  1037.  
  1038.           3.5  Clear the Screen - Alt C
  1039.  
  1040.             Pressing the <ALT> and the "C" key clears the screen and resets
  1041.           the current color attributes.  Many host systems send color
  1042.           information which stays in place even after you log off. Clear
  1043.           Screen resets the screen colors to the ones you chose.
  1044.  
  1045.  
  1046.           3.6  Dialing Functions - Alt D
  1047.  
  1048.             Pressing the <ALT> and the "D" keys displays the MyComm Dial
  1049.           Screen.  From this screen you may add, delete, edit, view, find,
  1050.           and mark phone list entries, and of course dial phone list
  1051.           entries.  You will see the options available from this screen
  1052.           written into the little window at the bottom of the screen. The
  1053.           letter which activates an option will appear highlighted or in a
  1054.           different color.  A description of the dialing functions follows.
  1055.  
  1056.             You will see a bar highlighting the current phone list item.
  1057.           The highlight bar may be moved up and down by using the Up-Arrow,
  1058.           Down-Arrow, Page Up, Page Down, Home and End keys.  The highlight
  1059.           bar appears as reverse video bar on monochrome screens.
  1060.  
  1061.  
  1062.           MyComm Version 2.20 Documentation                    Page 17
  1063.  
  1064.  
  1065.  
  1066.  
  1067.           +------------------------------------------------| Dial Screen |+
  1068.           |                                                               |
  1069.           |   #   Name                     Phone Number         Last Call |
  1070.           |                                                               |
  1071.           |   1   Your Favorite BBS       555-4657               01/26/92 |
  1072.           |   2   The Music Board         555-8944               01/19/92 |
  1073.           |   .           .                  .                      .     |
  1074.           |   .           .                  .                      .     |
  1075.           |   .           .                  .                      .     |
  1076.           |  15                                                  00/00/00 |
  1077.           |---------------------------------------------------------------|
  1078.           |                                                               |
  1079.           | Add  Edit  Delete  Call  Info  Manual  (Un)MarK  Find  Load   |
  1080.           |                    Sort  moVe  Print                          |
  1081.           +---------------------------------------------------------------+
  1082.  
  1083.  
  1084.           3.6.1  Add Phone List Item
  1085.  
  1086.             Pressing the "A" key in the Dial Screen window adds a blank
  1087.           entry after the currently highlighted entry.
  1088.  
  1089.  
  1090.           3.6.2  Edit Phone List Item Screen
  1091.  
  1092.             Pressing the "E" key in the Dial Screen window brings up the
  1093.           Dial Edit window.  This is where you set up the phone list entry
  1094.           for each system you will call.  There are several options to
  1095.           choose from, and each is described.  You may also use the Up-
  1096.           Arrow and Down-Arrow keys to move between items.  Items such as
  1097.           Name, Number, etc use MyComm's Line Editor described in Appendix
  1098.           B.
  1099.  
  1100.  
  1101.           MyComm Version 2.20 Documentation                    Page 18
  1102.  
  1103.  
  1104.  
  1105.           +----------------------------------------| Edit |+
  1106.           |                                                |
  1107.           | Name:                 Your Favorite BBS        |
  1108.           | Number:               555-4657                 |
  1109.           | Baud Rate: 2400       Data Bits: 8             |
  1110.           | Data Parity: None     Stop Bits: 1             |
  1111.           | Default Protocol:     1K-Xmodem                |
  1112.           | Dial Prefix: 1        ATDT*70                  |
  1113.           | Logon Name:           Your Name                |
  1114.           | Password:             Password                 |
  1115.           | Terminal Type: ANSI                            |
  1116.           | Local Echo: No                                 |
  1117.           | Received BS Destructive: Yes                   |
  1118.           | BS Key Sends BS or DELete: BS                  |
  1119.           | Strip Hi Bits? (Pure ASCII): No                |
  1120.           | Add LF after incoming CR?: No                  |
  1121.           | Script                                         |
  1122.           | Clear last date called and number of calls?    |
  1123.           |                                                |
  1124.           +------------------------------------------------+
  1125.  
  1126.           The following describes each phone list item and how to configure
  1127.           it.
  1128.  
  1129.           3.6.2.1  Name
  1130.  
  1131.             Just type in the name of the bulletin board system or person
  1132.           you will call here.
  1133.  
  1134.  
  1135.           3.6.2.2  Number
  1136.  
  1137.             The telephone number of the system you will call goes in here.
  1138.           The telephone number may include spaces or hyphens for
  1139.           readability (modems usually ignore spaces and hyphens).
  1140.           Characters such as letters or other gibberish will probably
  1141.           confuse your modem.  MyComm will assume that whatever you put
  1142.           here is a valid telephone number.
  1143.  
  1144.  
  1145.           3.6.2.3  Baud Rate
  1146.  
  1147.             Choose a baud rate (300, 1200, 2400, 4800, 9600, 19200, 38400,
  1148.           57600, or 115200) that you want MyComm to use when connected to
  1149.           the system.  For a more accurate reading of the data rate during
  1150.           file transfers (described elsewhere in this manual) and the on-
  1151.           line status (also described elsewhere in this manual) the baud
  1152.           rate should be set to the rate of the system that you will be
  1153.           calling.
  1154.  
  1155.  
  1156.           MyComm Version 2.20 Documentation                    Page 19
  1157.  
  1158.  
  1159.  
  1160.           3.6.2.4  Data Bits
  1161.  
  1162.             Choose the data bits (5, 6, 7, 8) that you want MyComm to use
  1163.           when connected to the system.  8 data bits is the most common
  1164.           setting for public bulletin board systems.  7 data bits are
  1165.           common on mainframes and many Unix (Tm) systems.  5 and 6 data
  1166.           bits are rarely used by many systems any longer, but are included
  1167.           for completeness.
  1168.  
  1169.             Most host systems in their advertisements, etc. tell you what
  1170.           Data, Parity, and Stop bits they expect.  You will often see them
  1171.           listed as 8-N-1 or similar.  8-N-1 means 8 data bits, no parity
  1172.           (None), and 1 stop bit. 8-N-1 is the most common setting used.
  1173.           If in doubt, try 8-N-1 first.
  1174.  
  1175.  
  1176.           3.6.2.5  Data Parity
  1177.  
  1178.             Choose the data parity (None, Even, Odd, Mark, Space) that you
  1179.           want MyComm to use when connected to the system.  None is usually
  1180.           used on most systems, especially with 8 data bits.  Even parity
  1181.           is common when using 7 data bits.
  1182.  
  1183.  
  1184.           3.6.2.6  Stop Bits
  1185.  
  1186.             Choose the stop bits (1, 2) that you want MyComm to use when
  1187.           connected to the system.  1 stop bit is the most common.
  1188.  
  1189.  
  1190.           3.6.2.7  Default Protocol
  1191.  
  1192.             MyComm allows you to choose the file transfer protocol that you
  1193.           will use by default for each system you call.  Choose the
  1194.           protocol which best suits your needs.  A more complete
  1195.           description of the various protocols is found later in this
  1196.           manual in the section on Uploading and DownLoading Files.
  1197.  
  1198.  
  1199.           3.6.2.8  Dial Prefix
  1200.  
  1201.             Choose the dialing prefix that you want MyComm to use when
  1202.           calling the number for this system.  MyComm has slots for three
  1203.           different dialing prefixes.  Choose one by moving the highlight
  1204.           bar to the selection you want.  The dialing prefixes may be
  1205.           changed to suit your needs in the Update Configuration menu
  1206.           option.
  1207.  
  1208.  
  1209.           MyComm Version 2.20 Documentation                    Page 20
  1210.  
  1211.  
  1212.  
  1213.           3.6.2.9  Logon Name
  1214.  
  1215.             This option lets you enter the name that you log on with when
  1216.           you call this system.  When bulletin board systems answer your
  1217.           call they usually ask for your name and password.
  1218.  
  1219.             Putting the characters "^M" at the end of the Logon Name causes
  1220.           an <Enter> character to be sent.  Some BBS's don't like seeing an
  1221.           <Enter> character immediately after the Logon Name string when
  1222.           logging on, in which case you should leave the "^M" out.
  1223.  
  1224.             If Logon Name is filled in MyComm will send your logon name
  1225.           when you push the <F2> key to save you some typing.
  1226.  
  1227.  
  1228.           3.6.2.10 Password
  1229.             This option lets you enter the password that you log on with
  1230.           when you call this system.  When bulletin board systems answer
  1231.           your call they usually ask for your name and password.
  1232.  
  1233.             If Password is filled in MyComm will send your logon password
  1234.           when you push the <F3> key to save you some typing.  If you are
  1235.           really security conscious, then you may leave this option blank.
  1236.  
  1237.             Putting the characters "^M" at the end of the Password causes
  1238.           an <Enter> character to be sent.  Some BBS's don't like seeing an
  1239.           <Enter> character immediately after the Password string when
  1240.           logging on, in which case you may leave the "^M" out.
  1241.  
  1242.  
  1243.           3.6.2.11 Terminal Type
  1244.             This option lets you choose the type of terminal emulation to
  1245.           use when calling this system.  The choices are TTY, ANSI, VT-52,
  1246.           VT-100 and 3270 (registered version only).
  1247.  
  1248.             TTY (TeleTYpe) gives no emulation what-so-ever. The characters
  1249.           appear on your screen just as they come in with no formatting.
  1250.  
  1251.             ANSI emulation provides functions similar to your ANSI.SYS
  1252.           driver to provide color attributes (except on mono monitors of
  1253.           course), blinking characters and other goodies.  MyComm uses
  1254.           intelligent ANSI character translation which filters out any ANSI
  1255.           sequences which cause "keyboard re-mapping".  This prevents the
  1256.           unscrupulous from sending ANSI sequences to your personal
  1257.           computer system that could potentially cause damage or annoyance.
  1258.  
  1259.             VT-52 and VT-100, and 3270 are most commonly used on mainframe
  1260.           hosts.  Some bulletin boards also support these.  Both of these
  1261.           emulations support a subset of the DEC protocols including a
  1262.           mapping to the "keypad mode" used to generate commands on DEC
  1263.  
  1264.  
  1265.           MyComm Version 2.20 Documentation                    Page 21
  1266.  
  1267.  
  1268.  
  1269.           terminals.  It should be noted that VT-52 is an "ANSI
  1270.           incompatible" emulation, and VT-100 is ANSI compatible.
  1271.  
  1272.             A listing of the keys supported for the ANSI, VT-52, VT-100,
  1273.           and 3270 emulations is in Appendix C - Terminal Emulations.
  1274.  
  1275.           3.6.2.12 Local Echo
  1276.  
  1277.             Local Echo is used when the other system does not send the
  1278.           characters typed on your terminal back to you.  Most systems do
  1279.           echo characters back, so Local Echo is normally off ("No").  If
  1280.           you find that you can't see what you are typing when connected to
  1281.           a system, set Local Echo on ("Yes").  On the other hand if you
  1282.           see double characters when you hit a key (for example you see
  1283.           "xx" when you type an "x") then Local Echo should be off ("No").
  1284.  
  1285.  
  1286.           3.6.2.13 Received BS (BackSpace) Destructive
  1287.  
  1288.             This option tells MyComm whether received BackSpace or DELete
  1289.           characters should back up the cursor and erase what was there.
  1290.           Usually this On.
  1291.  
  1292.  
  1293.           3.6.2.14 BS Key Sends BS or DELete
  1294.  
  1295.             This option tells MyComm whether to send a BS (BackSpace - 8
  1296.           decimal) or DEL (Delete - 127 decimal) character when the
  1297.           backspace key is pressed.  Usually this is set to BS.  Mainframe
  1298.           hosts usually like to see DEL rather than BS.
  1299.  
  1300.  
  1301.           3.6.2.15 Strip Hi Bits
  1302.  
  1303.             This option tells MyComm whether to strip the high bit from
  1304.           received and sent characters. Usually this is set to "No".
  1305.  
  1306.             Just for your own information, bytes on the personal computer
  1307.           are 8 bits long.  So, the bit-map of a byte might be 10011101.
  1308.           The left-most bit is the high bit.  So if you were to strip the
  1309.           high bit, the byte above would become 00011101.  Pure ASCII only
  1310.           covers bytes in the range of 00000000 (0 decimal) to 01111111
  1311.           (127 decimal).  The ANSI extended set includes values from
  1312.           10000000 (128 decimal) to 11111111 (255 decimal).  So by
  1313.           stripping the high bit, a character is guaranteed to be in the
  1314.           range of the pure ASCII character set.
  1315.  
  1316.  
  1317.           MyComm Version 2.20 Documentation                    Page 22
  1318.  
  1319.  
  1320.  
  1321.           3.6.2.16 Add LF after incoming CR
  1322.  
  1323.             This option tells MyComm whether to add a LF (Line Feed - 10
  1324.           decimal) character after a CR (Carriage Return - 13 decimal)
  1325.           character is received.  Usually this is set to "No".
  1326.  
  1327.             If you notice that the lines on the screen seem to look odd or
  1328.           do not scroll up properly, you will want to turn this on (Yes).
  1329.  
  1330.  
  1331.           3.6.2.17 Clear last date called and number of calls
  1332.  
  1333.             Each time you connect with a system MyComm updates the last
  1334.           date and time called portion the dialing entry record.  If you
  1335.           want to reset the date and time the system was last called and
  1336.           the number of times you have called it, answer "Yes" here.
  1337.  
  1338.           3.6.2.18 Script
  1339.  
  1340.             This is where you will put the name of the script file that you
  1341.           want to run ("Join") when you connect with this system.  For a
  1342.           complete discussion of the MyComm script language see Appendix -
  1343.           E "MyComm Script Language".
  1344.  
  1345.  
  1346.           3.6.2.19 Save Changes (not shown in example)
  1347.  
  1348.             MyComm asks if you want to save the changes you just made.  If
  1349.           you answer "Yes" MyComm updates the phone file on your disk
  1350.           drive.  When MyComm updates the phone file a backup of the phone
  1351.           file is created and named PHONE.OLD.
  1352.  
  1353.  
  1354.           3.6.3  Delete an Item
  1355.  
  1356.             Pressing the "T" key allows you to delete the item that is
  1357.           currently at the dialing highlight bar.  MyComm asks you to
  1358.           confirm the delete request before proceeding.  MyComm also
  1359.           updates the phone file on your disk drive.
  1360.  
  1361.  
  1362.           3.6.4  Call Numbers (Dial)
  1363.  
  1364.             Pressing the "C" key tells MyComm that it's time to start
  1365.           calling numbers in the Dialing List  (See also section 3.6.7
  1366.           (Un)MarK).  Pressing the <Enter> key also will start the dialing.
  1367.  
  1368.             If no Dialing List Items are "marked" MyComm will dial the
  1369.           number that the highlight bar is currently resting on.  If there
  1370.           are "marked" Dialing List Items, MyComm will start dialing the
  1371.           marked numbers in sequence until a connection is made.  During
  1372.  
  1373.  
  1374.           MyComm Version 2.20 Documentation                    Page 23
  1375.  
  1376.  
  1377.  
  1378.           the dialing attempts you may cancel the dialing by pressing the
  1379.           <Esc> key.
  1380.  
  1381.             While MyComm is calling numbers and waiting for a connection, a
  1382.           Dial Status Window is displayed (see example below).  The status
  1383.           window shows who is being called and the telephone number, how
  1384.           many call tries have been made so far, the status of the last
  1385.           dialing try, the time in seconds until this try "times out", the
  1386.           time since you started calling, and the time that the current
  1387.           dialing attempt started.
  1388.  
  1389.           +-------------------------------------------------------| Dial |+
  1390.           |                                                               |
  1391.           |  Calling: Your Favorite BBS        At: 555-4657               |
  1392.           |                                                               |
  1393.           |  Try # 1       Last Status: None Yet        Dial Time:  42    |
  1394.           |                                                               |
  1395.           |  Dialing started at:  3:01:20   This try started at:  3:01:21 |
  1396.           |                                                               |
  1397.           |                                                               |
  1398.           |          Hit ESC to quit dialing, 'N' for next number,        |
  1399.           |          or 'D' to delete number from list.                   |
  1400.           |                                                               |
  1401.           +---------------------------------------------------------------+
  1402.  
  1403.             Pressing the "N" key causes MyComm to stop dialing  the number
  1404.           it is currently dialing and to skip to the next marked number.
  1405.  
  1406.             Pressing the "D" key causes MyComm to stop dialing the number
  1407.           it is currently calling and to remove it from the list of
  1408.           "marked" numbers.  If you press "D" and the number is the only
  1409.           one left in the "marked" list, MyComm will give you a warning and
  1410.           stop dialing.
  1411.  
  1412.             The Dial Time and Pause Time between calls is a user
  1413.           configuration option which may be set up in the Update
  1414.           Configuration menu described later in this document.
  1415.  
  1416.           3.6.5  Phone Item Info Screen
  1417.  
  1418.             The Phone Item Info Screen looks very much like the Edit Phone
  1419.           List Item Screen with the exception that the Last Call Date, Last
  1420.           Call Time, and Number of Calls fields are shown.  If you see
  1421.           something you want to change, pressing "E" will bring you to the
  1422.           Edit Phone List Item Screen.
  1423.  
  1424.  
  1425.           MyComm Version 2.20 Documentation                    Page 24
  1426.  
  1427.  
  1428.  
  1429.  
  1430.           +------------------------------| Phone Item Info |+
  1431.           |                                                 |
  1432.           | Name:                 Your Favorite BBS         |
  1433.           | Number:               555-4657                  |
  1434.           | Baud Rate: 2400       Data Bits: 8              |
  1435.           | Data Parity: None     Stop Bits: 1              |
  1436.           | Default Protocol:     1K-Xmodem                 |
  1437.           | Dial Prefix: 1        ATDT*70                   |
  1438.           | Logon Name:           Your Name                 |
  1439.           | Password:             Password                  |
  1440.           | Terminal Type: ANSI                             |
  1441.           | Local Echo: No                                  |
  1442.           | Received BS Destructive: Yes                    |
  1443.           | BS Key Sends BS or DELete: BS                   |
  1444.           | Strip Hi Bits? (Pure ASCII): No                 |
  1445.           | Add LF after incoming CR?: No                   |
  1446.           |                                                 |
  1447.           | Last Call Date:       01/26/92                  |
  1448.           | Last Call Time:        4:26:12                  |
  1449.           | Number of Calls:            28                  |
  1450.           |                                                 |
  1451.           |          Press "E" to Edit Record               |
  1452.           +-------------------------------------------------+
  1453.  
  1454.  
  1455.           3.6.6  Manual Dial Screen
  1456.  
  1457.             Pressing "M" brings up the Manual Dial Screen.  The Manual Dial
  1458.           Screen lets you enter a single phone number to dial.  The dialing
  1459.           prefix used is always Dialing Prefix number 1.
  1460.           Pressing <Esc> cancels the function.  Pressing <Enter> accepts
  1461.           the telephone number and the usual Dialing Status Window appears.
  1462.  
  1463.           +-------------------------------------| Manual Dial |+
  1464.           |                                                    |
  1465.           |  Enter phone number: 555-1234                      |
  1466.           |                                                    |
  1467.           +----------------------------------------------------+
  1468.  
  1469.  
  1470.           3.6.7  Mark Phone List Items
  1471.  
  1472.             Pressing "K" marks or un-marks phone list items for later
  1473.           dialing.  As a convenience, pressing the <Space> bar also marks
  1474.           and un-marks items.  When a phone list item is marked a chevron
  1475.           ("»") will appear next to the item.
  1476.  
  1477.  
  1478.           MyComm Version 2.20 Documentation                    Page 25
  1479.  
  1480.  
  1481.  
  1482.           3.6.8  Find Phone List Items
  1483.  
  1484.             Pressing "F" brings up the Find Phone List Items screen (not
  1485.           shown).  Simply type in the characters in the name, or a partial
  1486.           phone number that you want to find.  The search is started at the
  1487.           top of the list.  If the search fails, a message is displayed.
  1488.  
  1489.  
  1490.           3.6.9  Load Phone List Screen
  1491.  
  1492.             Pressing "L" brings up the Load Phone List Screen.  You may
  1493.           keep more than one phone dialing list.  Each list will hold up to
  1494.           100 telephone numbers.  If the dialing list you select does not
  1495.           yet exist, MyComm will display an empty dialing list.
  1496.             Again, when changes are made to the phone file, MyComm will
  1497.           create or update the file PHONE.OLD as a backup.  There is only
  1498.           one PHONE.OLD backup file kept, so all new backups overwrite the
  1499.           last PHONE.OLD backup file.
  1500.  
  1501.  
  1502.           3.6.10 Sort Phone List
  1503.  
  1504.             You may sort the Phone List in one of four ways:
  1505.  
  1506.             - by BBS name
  1507.             - by Telephone number
  1508.             - by last date called
  1509.             - by number of times called
  1510.  
  1511.             The sort option will also ask you for Ascending or Descending
  1512.           sort order.  Simply select the sort option that best suits your
  1513.           needs.  The list will be saved in the new sort order.  Pressing
  1514.           <Esc> exits the Sort menu.
  1515.  
  1516.  
  1517.           3.6.11 Move Phone List Item
  1518.  
  1519.             This option allows you to move a phone list item to another
  1520.           location in the list.  This will save you some retyping if you
  1521.           want to customize your phone list.
  1522.  
  1523.             To use this option move the highlight bar to the phone list
  1524.           item that you want to move.  Press the "V" key.  Next use the up
  1525.           and down arrow keys to move the highlight bar to the position
  1526.           that you would like the item moved to.  Press the <Enter> key to
  1527.           make the move permanent, or <Esc> to quit the move.
  1528.  
  1529.  
  1530.           MyComm Version 2.20 Documentation                    Page 26
  1531.  
  1532.  
  1533.  
  1534.           3.6.12 Print Phone List
  1535.  
  1536.             This option allows you to print the phone list.  The phone list
  1537.           may also be "printed" to a text file.  The printed output shows
  1538.           the BBS name, phone number, and last date called.
  1539.  
  1540.             To use this option press "P".  You will then be asked for a
  1541.           file name to "print" to.  To print to your printer (PRN) simply
  1542.           press <Enter> (PRN is a standard DOS device name for the
  1543.           printer).  A status message is displayed while the phone list is
  1544.           being printed.  The printing may be stopped by pressing the <Esc>
  1545.           key.
  1546.  
  1547.  
  1548.           3.7  Local Echo On/Off - Alt E
  1549.  
  1550.             Local Echo is used when the other system does not send the
  1551.           characters you typed on your terminal back to you.  Most systems
  1552.           do echo characters back, so Local Echo is normally off ("No").
  1553.           If you find that you can't see what you are typing when connected
  1554.           to a system, set Local Echo on (Yes).  On the other hand if you
  1555.           see double characters when you hit a key (for example you see
  1556.           "xx" when you type an "x") then Local Echo should be off ("No").
  1557.  
  1558.  
  1559.           3.8  Hang Up Modem - Alt H
  1560.  
  1561.               Pressing the <ALT> and the "H" key tells MyComm that you want
  1562.           to disconnect from your current telephone connection.  MyComm
  1563.           will try to hang up the phone first by dropping the modem signal
  1564.           called DTR, and if that fails by sending the Hang Up String
  1565.           defined in the Modem Setup Screen (see section 3.17.1  Modem
  1566.           Setup Screen).  If you don't want MyComm to use DTR to hang up
  1567.           the modem set the option "Use DTR to Hang Up Modem" in Modem
  1568.           Setup Screen to "No".
  1569.  
  1570.  
  1571.           3.9  Send Modem Initialization Strings - Alt I
  1572.  
  1573.             Pressing the <ALT> and the "I" key brings up the Send Init.
  1574.           String Menu shown below.  Choosing one of these options will send
  1575.           the Modem Initialization String, or the Hang Up String (same as
  1576.           <Alt> + H), or the Modem Attention String, or the Phone Answer
  1577.           String.  These strings are defined in the Modem Setup Screen (see
  1578.           section 3.17.1  Modem Setup Screen).
  1579.  
  1580.  
  1581.           MyComm Version 2.20 Documentation                    Page 27
  1582.  
  1583.  
  1584.  
  1585.  
  1586.                +-------| Send... |+
  1587.                | Init. String     |
  1588.                | Hang Up String   |
  1589.                | Attention String |
  1590.                | Phone Answer     |
  1591.                +------------------+
  1592.  
  1593.  
  1594.           3.10 Join Script - Alt J
  1595.  
  1596.             This option will allow you to "Join" in or run a script file.
  1597.           You will be asked to supply the name of the script file which
  1598.           MyComm will then load.  If the script file can not be opened you
  1599.           will see an error message.  You may quit the script by pressing
  1600.           the <Esc> key until you see the "Yes/No" window that asks if you
  1601.           want to quit the script.  See Appendix-E "Script Language" for
  1602.           more information on script files.
  1603.  
  1604.  
  1605.           3.11 Present Line Status - Alt L
  1606.  
  1607.             Pressing the <ALT> and the "L" key brings up the Present Line
  1608.           Status Window.  This window tells you the current COM Port
  1609.           Status, i.e. what Port, Baud Rate, Data Bits, Parity Bits, and
  1610.           Stop Bits are in effect, whether you are on-line and for how
  1611.           long.  If you are on-line MyComm tells you the name of the system
  1612.           you are logged onto, and the default file transfer protocol.
  1613.           Also shown is the present Local Echo status and whether Session
  1614.           Capture is active.  Pressing <Esc> closes the window.
  1615.  
  1616.           +--------------------------| Present Line Status |+
  1617.           |                                                 |
  1618.           |  COM Port Status COM2, 2400, 8, N, 1           |
  1619.           |    ----------------------------------------     |
  1620.           |                                                 |
  1621.           | On-line: Yes          Time On-line:  0:00:00    |
  1622.           | Logged on to:         My Favorite BBS           |
  1623.           | Current Protocol:     None                      |
  1624.           |    ----------------------------------------     |
  1625.           |                                                 |
  1626.           | Local Echo On:      No                          |
  1627.           | Screen Capture On:  Yes                         |
  1628.           |    ----------------------------------------     |
  1629.           |                                                 |
  1630.           | Current Time: 12:34:56          Date: 01/23/93  |
  1631.           +-------------------------------------------------+
  1632.  
  1633.  
  1634.           MyComm Version 2.20 Documentation                    Page 28
  1635.  
  1636.  
  1637.  
  1638.           3.12 Scroll Back - Alt K
  1639.  
  1640.             Pressing the <ALT> and the "K" key brings up the "scroll back"
  1641.           buffer.  MyComm saves the last few screens of received text for
  1642.           you.  This option allows you to see what has been recently
  1643.           received in case there was something that went by too quickly
  1644.           that you would like to look at again.  The scroll back buffer
  1645.           saves about two to three screens worth of information depending
  1646.           on how much actual text was in the previous screens (about 4K's
  1647.           worth).  The scroll back buffer does not display ANSI or high bit
  1648.           characters, they are stripped out to leave more room for useful
  1649.           information.
  1650.  
  1651.             When the scroll back buffer is first shown it displays the very
  1652.           beginning of the buffer information.  The up-arrow, down-arrow,
  1653.           Page Up, and Page Down keys scroll the text.  You may also write
  1654.           the buffer to a file by pressing the "W" key.  To exit press the
  1655.           <Esc> key.
  1656.  
  1657.  
  1658.           3.13 Manual Dial - Alt M
  1659.  
  1660.             Pressing the <ALT> and the "M" key brings up the Manual Dial
  1661.           Screen.  The Manual Dial Screen lets you enter in a single phone
  1662.           number to dial.  The dialing prefix used is always Dialing Prefix
  1663.           number 1.  The parity setting is always 8-N-1.
  1664.           If you press <Esc> you may cancel the selection.  Pressing
  1665.           <Enter> accepts the telephone number and the usual Dialing Status
  1666.           Window appears.  This is exactly the same function as in the
  1667.           Dialing Screen, selection "M", described above.
  1668.  
  1669.  
  1670.           3.14 Outside to DOS - Alt O
  1671.  
  1672.             Pressing the <ALT> and the "O" key lets you shell out of MyComm
  1673.           to DOS.  You may use the Outside to DOS even when you are on-
  1674.           line.  Typing "EXIT" on the DOS command line brings you back to
  1675.           MyComm.
  1676.  
  1677.             One point of interest here: if you switch to a different drive
  1678.           or directory while in the DOS shell, MyComm will automagically
  1679.           bring you back to the drive and directory you started from when
  1680.           you type "EXIT" to return to MyComm.
  1681.  
  1682.  
  1683.           MyComm Version 2.20 Documentation                    Page 29
  1684.  
  1685.  
  1686.  
  1687.           3.14 Change Port Parameters - Alt P
  1688.  
  1689.             Pressing the <ALT> and the "P" key brings up the Change Port
  1690.           Parameters Screen (see example below).  MyComm will let you
  1691.           change the port configuration, even while on-line.  Please note
  1692.           however that changing the COM Port while on-line will probably
  1693.           disconnect the current session.  However Data, Parity, and Stop
  1694.           Bits may be changed.
  1695.  
  1696.             Please note that the changes done here are not permanent.  To
  1697.           make permanent changes to the COM port settings, you must use the
  1698.           "Update Configuration" which is brought up by pressing <Alt> and
  1699.           "U" then the "M" key.
  1700.  
  1701.           +-----------------------| Change Port Parameters |+
  1702.           |                                                 |
  1703.           | Present settings: COM2, 2400, 8, N, 1           |
  1704.           |                                                 |
  1705.           | COM Port:2                                      |
  1706.           |                                                 |
  1707.           |           +---------+                           |
  1708.           |           | 1: COM1 |                           |
  1709.           +-----------| 2: COM2 |---------------------------+
  1710.                       | 3: COM3 |
  1711.                       | 4: COM4 |
  1712.                       | 5: COM5 |
  1713.                       | 6: COM6 |
  1714.                       | 7: COM7 |
  1715.                       | 8: COM8 |
  1716.                       +---------+
  1717.  
  1718.  
  1719.           3.16 Quick Re-Dial - Alt Q
  1720.  
  1721.             Pressing the <ALT> and the "Q" key allows you to redial the
  1722.           last number that MyComm dialed.  This is especially useful for
  1723.           re-dialing manually entered telephone numbers.
  1724.  
  1725.  
  1726.           3.17 Run External Program - Alt R
  1727.  
  1728.             Pressing the <ALT> and the "R" key brings up the Run External
  1729.           Program Screen (not shown).  MyComm lets you define an editor
  1730.           program plus up to three other programs that you may run without
  1731.           leaving your MyComm session.  The external programs are defined
  1732.           in Paths Setup (see 3.19.2  Paths Setup).
  1733.             If there is not enough available memory to run the external
  1734.           program, the external program will not run and control passes
  1735.           directly back to MyComm.
  1736.  
  1737.  
  1738.           MyComm Version 2.20 Documentation                    Page 30
  1739.  
  1740.  
  1741.  
  1742.           3.18 Session Capture On/Off/Pause - Alt S
  1743.  
  1744.             Pressing the <ALT> and the "S" key opens the MyComm Session
  1745.           Capture Screen (not shown).  You may either accept the default
  1746.           name that MyComm provides for the capture file or enter a new
  1747.           name.  If the Drive:\Path\Filename is in any way invalid, MyComm
  1748.           will issue an error message.  You may also press <Esc> to leave
  1749.           the Session Capture Screen without starting the Session Capture.
  1750.  
  1751.             After a Session Capture has begun pressing the <ALT> and the
  1752.           "S" key again will allow you to Close, or Pause/Resume the
  1753.           capture file.
  1754.  
  1755.             If you exit MyComm and forget to Close the Session Capture
  1756.           file, MyComm will do it for you.
  1757.  
  1758.             Please note that often while Session Capture is active, that
  1759.           the display may appear jerky, or start and stop from time to
  1760.           time.  This is normal during Session Capture as it is the time
  1761.           that MyComm is writing the file to disk.
  1762.  
  1763.  
  1764.             It may also be important to know that the Session Capture does
  1765.           not do any ANSI filtering.  What you see is what you get.
  1766.           Generally you will read the Session Capture file using a text
  1767.           editor or word processor when you are no longer "on line".  Text
  1768.           editors and word processors often perform ANSI filtering for you.
  1769.  
  1770.  
  1771.           3.19 Terminal Emulation - Alt T
  1772.  
  1773.             MyComm allows you to reset the Terminal Emulation even while
  1774.           on-line.  The options are: TTY, ANSI, VT-52, VT-100, and 3270.
  1775.           Further information on the emulation may be found in Appendix C -
  1776.           "Terminal Emulations".
  1777.  
  1778.           3.20 Update Configuration - Alt U
  1779.  
  1780.             Pressing the <ALT> and the "U" key brings up the Update
  1781.           Configuration Menu (see below).  From this menu you may choose
  1782.           various options to allow you to customize the MyComm
  1783.           configuration.  You may either use the Up and Down-Arrow keys,
  1784.           then press <Enter> to choose an option, or simply press the
  1785.           highlighted letter of the option you want.  A description of the
  1786.           options that may be configured follows.
  1787.  
  1788.  
  1789.           MyComm Version 2.20 Documentation                    Page 31
  1790.  
  1791.  
  1792.  
  1793.  
  1794.                      +---| Update Configuration |+
  1795.                      | Modem Setup               |
  1796.                      | Paths and Filenames       |
  1797.                      | File Transfer Options     |
  1798.                      | Other Stuff for MyComm    |
  1799.                      | COM Port Addresses        |
  1800.                      | Save Configuration        |
  1801.                      | Exit                      |
  1802.                      +---------------------------+
  1803.  
  1804.  
  1805.           3.20.1  Modem Setup Screen
  1806.  
  1807.             The Modem Setup Screen (see below) allows you to make changes
  1808.           to the various setting that control the modem.  You may move from
  1809.           item to item by using the Up and Down-Arrow keys and then
  1810.           pressing <Enter>.  Some of the items use MyComm's built in line
  1811.           editor to modify the item, others use little pop-up Yes/No
  1812.           windows.  If you want to exit without making any changes, just
  1813.           press the <Esc> key.  A description of each item in the Modem
  1814.           Setup Screen follows.
  1815.  
  1816.           +------------------------------------------------| Modem Setup |+
  1817.           |                                                               |
  1818.           | COM Port:                        COM2, 2400, 8, N, 1          |
  1819.           | Modem Initialization String:     ATM0X4Q0V1S0=0S11=50S7=50^M  |
  1820.           | Modem Attention String:          +++                          |
  1821.           | Modem Hang Up String:            ATH0^M                       |
  1822.           | Modem Answer String:             ATA^M                        |
  1823.           | Modem Cancel Dial String:        ^M                           |
  1824.           | Modem Dial Suffix String:        ^M                           |
  1825.           | Dialing Wait Time, in Seconds:    45                          |
  1826.           | Pause Between Calls, in Seconds:   4                          |
  1827.           | Local Echo on by Default?        No                           |
  1828.           | Use DTR to Hang Up Modem?        Yes                          |
  1829.           | Use XON/XOFF Flow Control?       Yes                          |
  1830.           | Use CTS/RTS Flow Control?        No                           |
  1831.           | Use DSR/DTR Flow Control?        No                           |
  1832.           | Dialing Prefix #1:               ATDT*70                      |
  1833.           | Dialing Prefix #2:               ATDT 9,                      |
  1834.           | Dialing Prefix #3:               ATDT 1                       |
  1835.           |                                                               |
  1836.           |                                                               |
  1837.           |          Use Up and Down Arrows to move between items         |
  1838.           |               Hit <Enter> to edit, <Esc> to Quit              |
  1839.           |                                                               |
  1840.           +---------------------------------------------------------------+
  1841.  
  1842.  
  1843.           MyComm Version 2.20 Documentation                    Page 32
  1844.  
  1845.  
  1846.  
  1847.           3.20.1.1  COM Port
  1848.  
  1849.             The COM Port selection allows you to set various COM port
  1850.           settings.
  1851.             When you first installed your modem you probably set the COM
  1852.           port up for COM1, COM2, etc. use the setting correct for your
  1853.           modem.  If you set the wrong COM port in this area, MyComm
  1854.           doesn't mind, but won't let you dial numbers later on.
  1855.  
  1856.             MyComm does not re-initialize the COM port when you make
  1857.           changes in this menu.  The new COM port settings will be used the
  1858.           next time that you run MyComm.  If you need to change the COM
  1859.           port settings now, use the Alt-P function from the main terminal
  1860.           screen.
  1861.  
  1862.             The baud rate should be set to whatever the top speed of your
  1863.           modem is.  Refer to your modem user manual if you're not sure.
  1864.  
  1865.             The most common settings for the Data, Parity, and Stop bits
  1866.           are 8-N-1 (8 data bits, no parity, 1 stop bit).  If you require
  1867.           different settings, this is the place to change them.
  1868.  
  1869.  
  1870.           3.20.1.2  Modem Initialization String
  1871.  
  1872.             This option lets you set up the Modem Initialization String.
  1873.           This is the string which is sent to the modem to "wake it up" and
  1874.           set options when MyComm is first loaded.  The initialization
  1875.           string is made up of Hayes "AT" commands.  The command line
  1876.           always starts with the letters "AT".  The rest of the line
  1877.           contains various options for your modem.  Your modem manual
  1878.           should have a list of the commands that are valid for your modem.
  1879.  
  1880.             MyComm always likes to have AT LEAST the Q0, V1, and X4
  1881.           commands.  Q0 tells the modem to ALWAYS send result codes, V1
  1882.           tells the modem to ALWAYS send the text, not numeric, result
  1883.           codes.  MyComm needs the result codes in text format to monitor
  1884.           call progress, and to send you other useful information that the
  1885.           modem produces.  X4 (your modem may use X1, X2, etc) tells the
  1886.           modem to send "verbose" modem status information to MyComm.
  1887.             You should place "^M" at the end of the Initialization String
  1888.           so that MyComm will send a Carriage Return at the end of the
  1889.           line.
  1890.  
  1891.           High speed modem users: If you need to set "flow control" options
  1892.           for your modem in the setup string this is the place to do it.
  1893.           For example, if your modem needs to use RTS/CTS flow control the
  1894.           Hayes AT command "&K3" should be added to the initialization
  1895.           string.
  1896.  
  1897.  
  1898.           MyComm Version 2.20 Documentation                    Page 33
  1899.  
  1900.  
  1901.  
  1902.           3.20.1.3  Modem Attention String
  1903.  
  1904.             This is the Attention signal that tells the modem that you want
  1905.           it's undivided attention for something.  Most Hayes compatible
  1906.           modems use three plus signs "+++" as the attention string.  Refer
  1907.           to your modem manual if you use a different Attention string.
  1908.  
  1909.  
  1910.           3.20.1.4  Modem Hang Up String
  1911.  
  1912.             This is the string that tells your modem to hang up the
  1913.           telephone line.  On most Hayes compatible modems this is ATH0.
  1914.           You may use the characters "^M" to have MyComm send a Carriage
  1915.           Return after it sends the Hang Up string (recommended).  Refer to
  1916.           your modem manual if you use a different Hang Up string.
  1917.  
  1918.  
  1919.           3.20.1.5  Modem Answer String
  1920.  
  1921.             This is the string that tells your modem to answer the
  1922.           telephone.  On most Hayes compatible modems this is ATA.  You may
  1923.           use the characters "^M" to have MyComm send a Carriage Return
  1924.           after it sends the Answer string (recommended).  Refer to your
  1925.           modem manual if you use a different Answer string.
  1926.  
  1927.  
  1928.           3.20.1.6  Modem Cancel Dial String
  1929.  
  1930.             This is the string that tells your modem to cancel dialing a
  1931.           telephone number.  On most Hayes compatible modems this just a
  1932.           Carriage Return (13 decimal).  You may use the characters "^M" to
  1933.           send a Carriage Return after it sends the Cancel Dial string
  1934.           (recommended).  Refer to your modem manual if you use a different
  1935.           Cancel dialing string.
  1936.  
  1937.  
  1938.           3.20.1.7  Modem Dial Suffix String
  1939.  
  1940.             This is the string that tells your modem what to terminate
  1941.           telephone numbers with when dialing.  On most Hayes compatible
  1942.           modems this just a Carriage Return.  You may use the characters
  1943.           "^M" to have MyComm send a Carriage Return as the Dial Suffix
  1944.           string (recommended).  Refer to your modem manual if you use a
  1945.           different Dial Suffix string.
  1946.  
  1947.  
  1948.           MyComm Version 2.20 Documentation                    Page 34
  1949.  
  1950.  
  1951.  
  1952.           3.20.1.8  Dialing Wait Time
  1953.  
  1954.             After MyComm dials a number it waits for this amount of time
  1955.           for a connection.  Waiting stops automatically if MyComm detects
  1956.           a BUSY signal.  The valid range for Dialing Wait Time is 1 to 240
  1957.           seconds.
  1958.  
  1959.             In general a wait time of 45 seconds is good for most local and
  1960.           long-distance calls, 60 seconds for international calls.
  1961.  
  1962.             You will also want to add "S7=nn" (without the quotes), to your
  1963.           modem Initialization String (see above). Replace "nn" with a
  1964.           number greater than or equal to the time set in Dialing Wait
  1965.           Time.
  1966.  
  1967.  
  1968.           3.20.1.9  Pause Between Calls
  1969.  
  1970.             If a connection is not made after dialing due to a BUSY signal
  1971.           or a time-out, MyComm resets the modem and waits the amount of
  1972.           seconds specified in the Pause Between Calls before trying to
  1973.           dial again.  The valid range for Pause Between Calls is 0 to 60
  1974.           seconds.
  1975.  
  1976.             In most cases a pause time of 2 to 5 seconds is sufficient for
  1977.           the modem to reset.
  1978.  
  1979.  
  1980.           3.20.1.10 Local Echo on by Default
  1981.  
  1982.             Local Echo is used when the other system does not send what you
  1983.           typed on your terminal back to you.  Most systems do echo
  1984.           characters back, so Local Echo is normally off ("No").  If you
  1985.           find that you can't see what you are typing when connected to a
  1986.           system, set Local Echo on (Yes).  On the other hand if you see
  1987.           double characters when you hit a key (for example you see "xx"
  1988.           when you type an "x") then Local Echo should be off ("No").
  1989.  
  1990.  
  1991.           3.20.1.11 Use DTR to Hang Up Modem
  1992.  
  1993.             This option allows you to set whether MyComm should use the
  1994.           modem signal called DTR to terminate connections.  Using DTR to
  1995.           hang up is usually faster than just sending the Hang Up String
  1996.           (above).  This option is usually set to "Yes".
  1997.  
  1998.             However, some modems don't like to have DTR messed with. You
  1999.           can usually tell if the modem doesn't like you to fool with DTR
  2000.           as it will cause your computer system to lock up (not a bad thing
  2001.           really, just terribly annoying - re-booting always fixes this).
  2002.  
  2003.  
  2004.           MyComm Version 2.20 Documentation                    Page 35
  2005.  
  2006.  
  2007.  
  2008.           Refer to your modem manual if you have questions about whether to
  2009.           use DTR to hang up the telephone connection.
  2010.  
  2011.             NOTE: some modems require that you add "&D2" to your
  2012.           initialization string (see above) to enable the DTR line
  2013.           monitoring.  Check your modem manual for further details.
  2014.  
  2015.           3.20.1.12 Use XON/XOFF Flow Control
  2016.  
  2017.             This tells MyComm whether it should use the XON/XOFF flow
  2018.           control while in terminal mode and during ASCII file transfers.
  2019.           This default for this option is "Yes".
  2020.  
  2021.  
  2022.           3.20.1.13 Use CTS/RTS Flow Control
  2023.  
  2024.             This tells MyComm whether to use CTS/RTS flow control.
  2025.           This is used with high speed modems and null modem cable links to
  2026.           regulate the flow of data. If the modem supports CTS/RTS flow
  2027.           control this should be on (refer to the user manual for your
  2028.           modem).  If a null modem cable is being used and these signals
  2029.           are to be sent over the cable, this should be on.
  2030.             You may also want to add "&K3" to your initialization string
  2031.           (see above) to enable your modem to follow CTS/RTS status.  This
  2032.           option is most often used on high speed modems.
  2033.  
  2034.  
  2035.           3.20.1.14 Use DSR/DTR Flow Control
  2036.  
  2037.             This tells MyComm whether to use DSR/DTR flow control.
  2038.  
  2039.            Hardware handshaking is used with high speed modems and
  2040.           sometimes null modem cable links to regulate the flow of data.
  2041.           If the modem supports DSR/DTR flow control this should be "Yes"
  2042.           (refer to the user manual for your modem).  If a null modem cable
  2043.           is being used and these signals are to be sent over the cable,
  2044.           this should be on.
  2045.  
  2046.             You may also want to add "&D2" to your initialization string
  2047.           (see above) to enable your modem to follow DTR status.  This
  2048.           option is most often used on high speed modems.
  2049.  
  2050.  
  2051.           3.20.1.15 Dialing Prefixes
  2052.  
  2053.             Dialing Prefixes are dialing codes such as area codes, that get
  2054.           sent before a telephone number is dialed.  You may set up three
  2055.           different dialing prefixes.  Each dialing prefix may be up to 25
  2056.           character/digits long.
  2057.  
  2058.  
  2059.           MyComm Version 2.20 Documentation                    Page 36
  2060.  
  2061.  
  2062.  
  2063.             For example, if you have Call Waiting (Tm) you can disable it
  2064.           by dialing *70 (that's asterisk - 70) before the number you're
  2065.           calling (this works in the my dialing area, your dialing area may
  2066.           differ).  If you were to set one of your dialing prefixes to *70
  2067.           MyComm would "prefix" every number you called with *70.  The
  2068.           dialing prefixes may also be used to store long distance codes,
  2069.           or whatever dialing codes you would want to have dialed before a
  2070.           number.
  2071.  
  2072.           3.20.1.16 Connect Strings
  2073.  
  2074.             MyComm will use the strings defined in Connect and No Connect
  2075.           strings to determine the dialing status.  From this option you
  2076.           will be able to change the strings that MyComm will use as
  2077.           responses from your modem.
  2078.  
  2079.             There is one "Connect" string and four "No Connect" strings.
  2080.  
  2081.             The Connect string should be the same as the one your modem
  2082.           generates when a connection has been made.  The default is
  2083.           "CONNECT" which is fairly standard.  Please note: you must define
  2084.           this string so that MyComm will know when a connection has been
  2085.           made.  MyComm does not rely on the Carrier Detect signal to
  2086.           determine when it has connected during dialing!
  2087.  
  2088.             The "No Connect" strings should be set to whatever strings your
  2089.           modem generates when a connection is not made during dialing.
  2090.           When MyComm sees one of these responses from the modem during
  2091.           dialing it stops waiting for a connection and moves on to the
  2092.           next number to be dialed.  The default strings are "BUSY", "NO
  2093.           CARRIER", "NO DIALTONE", and "VOICE".
  2094.  
  2095.  
  2096.           3.20.2  Paths Setup
  2097.  
  2098.             The Paths Setup Screen (see below) is where you set up paths to
  2099.           directories that you want MyComm to know about.  A description of
  2100.           the various system paths follows.
  2101.  
  2102.  
  2103.           MyComm Version 2.20 Documentation                    Page 37
  2104.  
  2105.  
  2106.  
  2107.  
  2108.  
  2109.           +---------------------------------------------| Paths Setup |+
  2110.           |                                                            |
  2111.           | Directory to Download files to:  C:\PUBLIC\                |
  2112.           | Directory to Upload files from:  C:\PUBLIC\                |
  2113.           | Path\File for Screen Capture:    C:\PUBLIC\MYCOMM.SCR      |
  2114.           | Path\File for Session Capture:   C:\PUBLIC\MYCOMM.SES      |
  2115.           | Path\File for Phone File:        C:\MYCOMM\MYCOMM.PHN      |
  2116.           | Path\Filename.Ext for Editor:    C:\UTIL\EDITOR.EXE        |
  2117.           | Path\Filename.Ext of Xter Prog1: C:\SOMEPRGM.EXE           |
  2118.           | Path\Filename.Ext of Xter Prog2: C:\                       |
  2119.           | Path\Filename.Ext of Xter Prog3: C:\                       |
  2120.           |                                                            |
  2121.           |                                                            |
  2122.           |      Use Up and Down Arrows to move between items          |
  2123.           |           Hit <Enter> to edit, <Esc> to Quit               |
  2124.           |                                                            |
  2125.           +------------------------------------------------------------+
  2126.  
  2127.  
  2128.           3.20.2.1  Download Directory
  2129.  
  2130.             This option tells MyComm which directory you want MyComm to put
  2131.           files that are downloaded from another system.  Notice that the
  2132.           path always ends in a backslash ( "\" ) character.
  2133.  
  2134.  
  2135.           3.20.2.2  Upload Directory
  2136.  
  2137.             This option tells MyComm which directory you want MyComm to get
  2138.           the files from that will be uploaded to other systems.  Notice
  2139.           that the path always ends in a backslash ( "\" ) character.
  2140.  
  2141.  
  2142.           3.20.2.3  Path\File for Screen Capture
  2143.  
  2144.             This option tells MyComm which directory and the filename that
  2145.           you want MyComm to use for the Screen Capture file.  Screen
  2146.           Capture is activated by <Alt> + W.
  2147.  
  2148.  
  2149.           3.20.2.4  Session Capture Path\File
  2150.  
  2151.             This option tells MyComm which directory and the filename that
  2152.           you want MyComm to use for the Session Capture file.  Session
  2153.           Capture is activated by <Alt> + S.
  2154.  
  2155.  
  2156.           MyComm Version 2.20 Documentation                    Page 38
  2157.  
  2158.  
  2159.  
  2160.           3.20.2.5  Phone File Path\File
  2161.  
  2162.             This option tells MyComm which directory and the filename that
  2163.           you want MyComm to use for the Phone File which contains your
  2164.           dialing directory.  You may have multiple Phone Files, but this
  2165.           is the one that MyComm will load when it starts up.
  2166.  
  2167.  
  2168.           3.20.2.6  Editor Path\Filename
  2169.  
  2170.             If you want to use an editor program without leaving MyComm,
  2171.           this option lets you tell MyComm the path and filename of the
  2172.           editor.  Notice that the filename of the editor must include not
  2173.           only the filename, but the extension (.EXE or .COM) as well.
  2174.  
  2175.  
  2176.           3.20.2.7  External Programs Path\Filename
  2177.  
  2178.             You may define up to three other external programs to run
  2179.           without leaving your MyComm session.  Use these options to tell
  2180.           MyComm the paths and filenames of the programs.  Notice that the
  2181.           filename of the programs must include not only the filename, but
  2182.           the extension (.EXE, .COM, or .BAT) as well.
  2183.  
  2184.  
  2185.           3.20.3  Protocols Setup
  2186.  
  2187.             The Protocols Setup Menu (see example below) allows changes to
  2188.           parameters for ASCII file transfers, Kermit file transfers,
  2189.           Zmodem file transfers, and the external protocols.
  2190.           The usage of these options follows.
  2191.  
  2192.                +--| Protocol Setup |+
  2193.                | ASCII Transfers    |
  2194.                | Zmodem Transfers   |
  2195.                | Kermit Transfers   |
  2196.                | EXternal Protocols |
  2197.                | Exit               |
  2198.                +--------------------+
  2199.  
  2200.  
  2201.           3.20.3.1  ASCII Transfers Setup
  2202.  
  2203.             The ASCII Transfers Setup screen (see example below) lets you
  2204.           set up the parameters for ASCII file transfers.  ASCII file
  2205.           transfers are only used to transfer text files.  Program files
  2206.           and archived files, also known as binary files, should not be
  2207.           transferred as ASCII files.  Most of the options for the ASCII
  2208.           transfers work well with their default settings.  A description
  2209.           of the different options follows.
  2210.  
  2211.  
  2212.           MyComm Version 2.20 Documentation                    Page 39
  2213.  
  2214.  
  2215.  
  2216.  
  2217.  
  2218.           +----------------------------| ASCII Transfers Setup |+
  2219.           |                                                     |
  2220.           | Strip High Bits?:                 No                |
  2221.           | Remote Abort Char (0 for none):    0 (ASCII Value)  |
  2222.           |                                                     |
  2223.           | ASCII Upload Options                                |
  2224.           | CR Translation:                 None                |
  2225.           | LF Translation:                 None                |
  2226.           | Local Echo On During Uploads?:   Yes                |
  2227.           | Expand Blank Lines to Spaces?:    No                |
  2228.           | Line Pace time in 1/10 seconds:    0                |
  2229.           | Char Pace time in 1/10 seconds:    0                |
  2230.           | Pacing Char (0 for none):          0 (ASCII Value)  |
  2231.           |                                                     |
  2232.           | ASCII Download Options                              |
  2233.           | CR Translation:                 None                |
  2234.           | LF Translation:                 None                |
  2235.           |                                                     |
  2236.           |    Use Up and Down Arrows to move between items     |
  2237.           |          Hit <Enter> to edit, <Esc> to Quit         |
  2238.           +-----------------------------------------------------+
  2239.  
  2240.  
  2241.           3.20.3.1.1  Strip High Bits
  2242.             This option tells MyComm whether to strip the high bit from
  2243.           received and sent characters during ASCII uploads and downloads.
  2244.           Usually this is set to "No".  See also section 3.6.2.15 "Strip
  2245.           High Bits" for a discussion of "high bits".
  2246.  
  2247.  
  2248.           3.20.3.1.2  Remote Abort Char
  2249.  
  2250.             If the system you're performing the ASCII file transfer with
  2251.           uses an abort char to cancel transfers you should set this value.
  2252.           The value is in the range of 1 to 255.  A value of zero (0), the
  2253.           default, means MyComm won't look for the abort character during
  2254.           ASCII file transfers.
  2255.  
  2256.  
  2257.           3.20.3.1.3  CR Translation Upload and Download
  2258.  
  2259.             Some systems require a CR (Carriage Return) character placed
  2260.           before the LF (Line Feed) character during ASCII file transfers.
  2261.           If the lines of the file look odd after the transfer, this may be
  2262.           the case.
  2263.  
  2264.  
  2265.           MyComm Version 2.20 Documentation                    Page 40
  2266.  
  2267.  
  2268.  
  2269.           3.20.3.1.4  LF Translation Upload and Download
  2270.  
  2271.             Some systems require a LF (Line Feed) character placed after
  2272.           the CR (Carriage Return)  character during ASCII file transfers.
  2273.           If the lines of the file look odd after the transfer, this may be
  2274.           the case.
  2275.  
  2276.  
  2277.           3.20.3.1.5  Local Echo On During Uploads
  2278.  
  2279.             During ASCII uploads if you want to watch the file transfer set
  2280.           this option to "Yes".  This is often used when uploading a
  2281.           message into a bulletin boards message base.  When this option is
  2282.           set to "No", the usual file transfer window is shown as the
  2283.           upload progresses.  Please note that when this option is set to
  2284.           "No" a Ctrl-Z (end of file marker) character is sent at the end
  2285.           of the file transfer.  When set to "Yes" the Ctrl-Z is not sent.
  2286.  
  2287.  
  2288.           3.20.3.1.6  Expand Blank Lines to Spaces
  2289.  
  2290.             This option tells MyComm to expand lines that are empty except
  2291.           for a CR/LF into a line of spaces that end with a CR/LF.  This is
  2292.           useful when you are uploading a message to a bulletin board.
  2293.           Some boards interpret a blank line with only a CR/LF as the end
  2294.           of message signal.  Expanding blank lines allows you to upload
  2295.           the entire message.
  2296.  
  2297.  
  2298.           3.20.3.1.7  Line Pace Time
  2299.  
  2300.             This options tells MyComm to how much time to wait between
  2301.           sending each line of text from the ASCII file.  Some systems
  2302.           can't handle high speed ASCII transfers, this gives the other
  2303.           system time to "think".  The value entered from 0 (the default)
  2304.           to 255 are in increments of 1/10 second (approximately).
  2305.  
  2306.  
  2307.           3.20.3.1.8  Character Pace Time
  2308.  
  2309.             This options tells MyComm how much time to wait before sending
  2310.           each character from the ASCII file.  Some systems can't handle
  2311.           high speed ASCII transfers, this gives the other system time to
  2312.           "think".  The value entered from 0 (the default) to 255 is in
  2313.           increments of 1/10 second (approximately).
  2314.  
  2315.  
  2316.           MyComm Version 2.20 Documentation                    Page 41
  2317.  
  2318.  
  2319.  
  2320.           3.20.3.1.9  Pacing Char
  2321.  
  2322.             Some systems send a Pacing Character to limit throughput on
  2323.           ASCII transfers.  MyComm will wait for the Pacing Char before
  2324.           sending each line of the file.  The Pacing Char value ranges from
  2325.           1 to 255 which represents an ASCII value.  A value of zero (0),
  2326.           the default, means MyComm will not look for the Pacing Char.
  2327.  
  2328.  
  2329.           3.20.3.2  Zmodem Transfers Setup
  2330.  
  2331.             MyComm lets you define certain special functions used in the
  2332.           Zmodem file transfer protocol.  A description of these follows.
  2333.  
  2334.  
  2335.           3.20.3.2.1  Zmodem 32 Bit CRC
  2336.  
  2337.             Zmodem uses either a 16 bit or a 32 bit CRC for error detection
  2338.           during file transfers.  The 32 bit CRC provides a much higher
  2339.           degree of accuracy than its 16 bit cousin.  However the
  2340.           calculation involved in the 32 bit CRC may slow the file transfer
  2341.           rate (by only a few CPS though).  If you want a high degree of
  2342.           error detection this option should be set to "Yes".  For higher
  2343.           transfer speed, set this option to "No".
  2344.  
  2345.  
  2346.           3.20.3.2.2  Zmodem Auto Download Feature
  2347.  
  2348.             When this option is set to "Yes" MyComm will automatically
  2349.           start a Zmodem download file transfer for you.  The Zmodem
  2350.           protocol at the host's end sends some special characters when it
  2351.           starts up a Zmodem transfer.  MyComm looks for these characters
  2352.           and will save you some typing by starting up the Zmodem download
  2353.           for you.  If you don't want to use this feature, set this option
  2354.           to "No".
  2355.  
  2356.  
  2357.           3.20.3.2.3  Zmodem Send Crash Recovery
  2358.  
  2359.             Sometimes a file transfer will fail after a file has been
  2360.           partially sent.   A file transfer could fail due to excessive
  2361.           line noise for example.  Zmodem has a rather nifty feature that
  2362.           will attempt to restart a failed file transfer.
  2363.  
  2364.             For normal use this feature should be set to "No".  If you want
  2365.           to attempt to restart a failed Zmodem transfer set this option to
  2366.           "Yes" before beginning the upload again.  If the system you are
  2367.           trying to upload the file to supports the "Crash Recovery"
  2368.           feature the file transfer will resume where it left off.
  2369.  
  2370.  
  2371.           MyComm Version 2.20 Documentation                    Page 42
  2372.  
  2373.  
  2374.  
  2375.           3.20.3.2.4  Zmodem Receive Crash Recovery
  2376.  
  2377.             Sometimes a file transfer will fail after a file has been
  2378.           partially received.  Zmodem has a rather nifty feature that will
  2379.           attempt to restart a failed file transfer.
  2380.  
  2381.             For Normal use this feature should be set to "No".  If you want
  2382.           to attempt to restart a failed Zmodem transfer then set this
  2383.           option to "Yes" before beginning the download again.  If the
  2384.           system you are trying to download the file from supports the
  2385.           "Crash Recovery" feature the file transfer will resume where it
  2386.           left off.
  2387.  
  2388.             THIS OPTION SHOULD BE USED WITH CARE.  If this option is set to
  2389.           "Yes" and you download a file from another system that has the
  2390.           same name as a file you already have in your download directory,
  2391.           the end of the existing file will be overwritten with the
  2392.           information from the new file.  This option should only be set to
  2393.           "Yes" when you are attempting to restart a previously failed
  2394.           Zmodem transfer.
  2395.  
  2396.             NOTE: the Zmodem Crash Recovery option has some rudimentary
  2397.           idiot proofing.  The option will not perform the transfer if the
  2398.           file you have has a different time/date stamp than the other
  2399.           system, or if the file that you have is larger than the file on
  2400.           the other system.
  2401.  
  2402.  
  2403.           3.20.3.4  Kermit Transfers Setup
  2404.  
  2405.             Kermit was designed to allow many different types of machines
  2406.           to send data to each other.  In order to do this Kermit places a
  2407.           special "escape" character before any control characters
  2408.           encountered.  However this compatibility does have its price,
  2409.           Kermit is one of the slowest protocols in use today.  There are
  2410.           several parameters that may be adjusted. Most people will never
  2411.           need to change any of these, but for those who may a brief
  2412.           description follows.
  2413.  
  2414.  
  2415.           MyComm Version 2.20 Documentation                    Page 43
  2416.  
  2417.  
  2418.  
  2419.  
  2420.           File Format:             Binary or ASCII. Generally 8 bit or 8th
  2421.                                    bit stripped (sometimes called "Text"
  2422.                                    mode) respectively
  2423.  
  2424.           Packet Size:             Allowable range is 10 to 94
  2425.  
  2426.           Number of Pad Chars:     0 - none, if needed valid range 1 to 94
  2427.  
  2428.           Pad Char:                0 - ignored, if needed valid range 1 to
  2429.                                    94
  2430.  
  2431.           Quote Char:              35 ASCII, 23 hex, # symbol by default
  2432.  
  2433.           Packet Start Char:       01 ASCII, SOH by default
  2434.  
  2435.           EOLN Char:               13 ASCII, 0D hex, carriage return by
  2436.                                    default
  2437.  
  2438.  
  2439.           3.20.3.4  External Protocols Setup
  2440.  
  2441.             Up to six external file transfer protocols may be defined.
  2442.           Once defined the external file transfer protocols will appear in
  2443.           the Upload and Download protocol selection menus.
  2444.             Use the Up and Down-Arrow keys to move from item to item.  The
  2445.           <Enter> key selects an item for editing and saves the completed
  2446.           edit.  Pressing the <Esc> key quits the edit.
  2447.  
  2448.  
  2449.           +-----------------------------------| External Protocols Setup |+
  2450.           |                                                               |
  2451.           | Protocol  Name    Upload.Bat    Download.Bat     Ask FileName |
  2452.           |                                                               |
  2453.           |   1:   BIGFAST    BIGFASTU.BAT  BIGFASTD.BAT     No           |
  2454.           |   2:                                             Yes          |
  2455.           |   3:                                             Yes          |
  2456.           |   4:                                             Yes          |
  2457.           |   5:                                             Yes          |
  2458.           |   6:                                             Yes          |
  2459.           |                                                               |
  2460.           |         Use Up and Down Arrows to move between items          |
  2461.           |               Hit <Enter> to edit, <Esc> to Quit              |
  2462.           +---------------------------------------------------------------+
  2463.  
  2464.             The name of the external protocol should be typed in under the
  2465.           "Name" heading as you would like it to appear in the MyComm
  2466.           Upload and Download protocol selection menus.
  2467.  
  2468.             In the fields for Upload.Bat and Download.Bat you will enter
  2469.           the names of the DOS batch files that will be used to run the
  2470.  
  2471.  
  2472.           MyComm Version 2.20 Documentation                    Page 44
  2473.  
  2474.  
  2475.  
  2476.           external protocol.  External file transfer protocols are run as
  2477.           DOS batch files from MyComm (see your DOS manual for information
  2478.           on batch files).
  2479.  
  2480.             In the selection marked "Ask FileName" tells MyComm whether you
  2481.           should be asked the name of the file when performing downloads
  2482.           (some file transfer protocols automatically get the filename for
  2483.           you).
  2484.  
  2485.             MyComm sends the COM Port number you are using, the Baud Rate,
  2486.           and the Drive:\Path\ and filename as parameters for the batch
  2487.           file.  Using the example above, let's say you are using an
  2488.           external protocol called "BigFast", your COM Port is 2, the Baud
  2489.           Rate is 2400, and your upload directory is "C:\PUBLIC\" and you
  2490.           are uploading a file called MYSTUFF.ARC. The batch file for
  2491.           Uploads with BigFast would look something like this:
  2492.  
  2493.               REM BigFast Upload batch file
  2494.               BigFast Send Port: %1  Baud: %2 %3
  2495.  
  2496.           the %1 would be replaced by a "2", the %2 by "2400", and the %3
  2497.           would be replaced with the name of the upload directory and the
  2498.           filename: "C:\PUBLIC\MYSTUFF.ARC" when MyComm calls the .BAT file
  2499.           to run.
  2500.  
  2501.             External file transfer protocols often differ quite a bit, but
  2502.           they usually come with enough documentation of their own to get
  2503.           you going.
  2504.  
  2505.           NOTE: Experience has shown that some external protocol drivers
  2506.           may not release the COM port properly when they have completed
  2507.           their business.  This causes the terminal to appear "locked" (no
  2508.           characters come across the scree).  MyComm attempts to restore
  2509.           the COM port after the external protocol has been called.  If
  2510.           your terminal appears locked the COM port can be reset by using
  2511.           the <ALT> + P function from the terminal window.
  2512.  
  2513.  
  2514.           3.20.4  Miscellaneous Options Setup
  2515.  
  2516.             The Miscellaneous Options Setup screen (see example below) lets
  2517.           you set up special options for MyComm.
  2518.  
  2519.  
  2520.           MyComm Version 2.20 Documentation                    Page 45
  2521.  
  2522.  
  2523.  
  2524.  
  2525.  
  2526.           +------------------------------------| Misc. Options Setup |+
  2527.           |                                                           |
  2528.           | Screen Background Color:         Black                    |
  2529.           | Screen Text Color:               Gray                     |
  2530.           | Date Format Style:               MMDDYY                   |
  2531.           | 12 or 24 Hour Time Format:       12 Hour                  |
  2532.           | Make Noise When Calls Connect?:  Yes                      |
  2533.           | Make Noise After File Transfers: Yes                      |
  2534.           | Use Direct Video? (Faster):      Yes                      |
  2535.           | Your Name for sign on :          Your Name^M              |
  2536.           | Password for sign on :           Password^M               |
  2537.           | Clever quip for TagLine:         Witty quote goes here... |
  2538.           | Guess Up/Download Filenames:     Yes                      |
  2539.           |                                                           |
  2540.           |         Use Up and Down Arrows to move between items      |
  2541.           |            Hit <Enter> to edit, <Esc> to Quit             |
  2542.           +-----------------------------------------------------------+
  2543.  
  2544.  
  2545.           3.20.4.1  Screen Background Color
  2546.  
  2547.             This option tells MyComm what color to use for the screen
  2548.           background color.  This option only affects the screen of the
  2549.           terminal window.
  2550.  
  2551.  
  2552.           3.20.4.2  Screen Text Color
  2553.  
  2554.             This option tells MyComm what color to use for the screen
  2555.           foreground (the text) color.  This option only affects the screen
  2556.           of the terminal window.
  2557.  
  2558.  
  2559.           3.20.4.3  Date Format Style
  2560.  
  2561.             You may choose three date formats for MyComm to use when it
  2562.           displays dates:  MM/DD/YY,  DD/MM/YY, or YY/MM/DD.  Choose
  2563.           whichever one best fits your mood.
  2564.  
  2565.  
  2566.           3.20.4.4  12 or 24 Hour Time Format
  2567.  
  2568.             MyComm will display the time in either 12 hour or 24 hour
  2569.           format. Choose the one that bests reflects how you identify with
  2570.           time.
  2571.  
  2572.  
  2573.           MyComm Version 2.20 Documentation                    Page 46
  2574.  
  2575.  
  2576.  
  2577.           3.20.4.5  Make Noise When Calls Connect
  2578.  
  2579.             MyComm sounds a short alarm noise when a connection is made
  2580.           during dialing.  If you don't want MyComm to sound the alarm, set
  2581.           this option to "No".
  2582.  
  2583.  
  2584.           3.20.4.6  Make Noise After File Transfers
  2585.  
  2586.             MyComm sounds a short alarm noise after a file transfer has
  2587.           completed.  If you don't want MyComm to make the noise, set this
  2588.           option to "No".
  2589.  
  2590.  
  2591.           3.20.4.7  Use Direct Video
  2592.  
  2593.             MyComm by default uses a system called "direct video" when
  2594.           displaying information to the screen.  Unfortunately, direct
  2595.           video will often "bleed through" to other programs in a
  2596.           multitasking environment.  If you are using a multitasker and
  2597.           getting bleed through from MyComm, set the Direct Video option to
  2598.           "No".
  2599.  
  2600.  
  2601.           3.20.4.8  Your Name for sign on
  2602.  
  2603.             This option lets you enter the name that you log on with when
  2604.           you call systems.  When bulletin board systems answer your call
  2605.           they usually ask for your name and password.  This name becomes
  2606.           the default for "Logon Name" for new numbers you add to the
  2607.           dialing directory.  If Logon Name is filled in MyComm will send
  2608.           your logon name to systems when you push the <F2> key to save you
  2609.           some typing.
  2610.  
  2611.  
  2612.           3.20.4.9  Password for sign on
  2613.  
  2614.             This option lets you enter the password that you log on with
  2615.           when you call systems.  When bulletin board systems answer your
  2616.           call they usually ask for your password.  This password becomes
  2617.           the default for "Logon Password" for new numbers you add to the
  2618.           dialing directory.  If Logon Password is filled in MyComm will
  2619.           send your logon password to systems when you push the <F3> key to
  2620.           save you some typing.
  2621.  
  2622.  
  2623.           MyComm Version 2.20 Documentation                    Page 47
  2624.  
  2625.  
  2626.  
  2627.           3.20.4.10 Clever quip for TagLine
  2628.  
  2629.             Many BBS's have message areas where you can converse with other
  2630.           people.  If you want to be able to sign your name, leave a witty
  2631.           quote or whatever without typing it over and over for each
  2632.           message fill this area in.  When you press the <F4> key MyComm
  2633.           will send the message you have entered here.  The message can be
  2634.           up to 40 characters long.  You may also send ANSI "Escape"
  2635.           sequences (see DOS manual) from the Tagline.
  2636.  
  2637.             If you want to send the ASCII "ESCape character (27 decimal, 1B
  2638.           hex) which usually precedes ANSI escape sequences, MyComm uses
  2639.           the characters "^[ ". ("caret" sign left bracket).  For example,
  2640.           the ANSI.SYS driver recognizes the string
  2641.  
  2642.           <Esc>[5mThis is blinking<Esc>[0m
  2643.  
  2644.           as a string that blinks. (note: <Esc> represents the 27 decimal
  2645.           (1B hex) character here).  So, if your Tagline looked like
  2646.  
  2647.           ^[[5mThis is blinking^[[0m
  2648.  
  2649.           the other system would display "This is blinking" as a blinking
  2650.           message line.
  2651.  
  2652.  
  2653.           3.20.4.11 Guess Up/Download Filename
  2654.  
  2655.             By default MyComm tries to "guess" the filename that you want
  2656.           to upload or download.  MyComm will make a best guess as to what
  2657.           you most recently typed that looked like a filename.  Having this
  2658.           option set to "Yes" can save you time and typing when performing
  2659.           file transfers.
  2660.  
  2661.  
  2662.           3.20.5  COM Port Addresses
  2663.  
  2664.             This option enables changes to the COM port addresses.  By
  2665.           default MyComm uses standard addresses and Interrupt Request
  2666.           Lines (IRQ) to communicate with your modem.  Most users will
  2667.           never have a need to use this option.  It is most commonly used
  2668.           when there is a conflict with a mouse or other serial device and
  2669.           the modem.  By changing the base address and IRQ line this
  2670.           problem can often be alleviated.  Modifying the COM port address
  2671.           table and IRQ settings can be tricky.  If you are not entirely
  2672.           certain that you know what you are doing this option is best left
  2673.           alone.
  2674.  
  2675.             You will see a table with the COM port number, the base address
  2676.           it is using, and the IRQ line.  You move from field to field by
  2677.           pressing the <Enter> key.  The base address is displayed in and
  2678.  
  2679.  
  2680.           MyComm Version 2.20 Documentation                    Page 48
  2681.  
  2682.  
  2683.  
  2684.           should be entered as a hexadecimal number.  The IRQ line will
  2685.           take numbers between 2 and 7.
  2686.  
  2687.             After you make changes you will have to reinstall the COM port.
  2688.           This is done by going back to the main terminal window and
  2689.           pressing <Alt> and 'P' and following the "Change Port" menu.
  2690.  
  2691.  
  2692.           3.20.6  Restore to Defaults
  2693.  
  2694.             This option will reset the MyComm configuration information to
  2695.           it's defaults.  A message will appear warning you of this, and a
  2696.           second "Yes/No" screen will ask if you want to proceed.  The
  2697.           changes take effect immediately, but are not saved until you use
  2698.           the "Save Setup" option.
  2699.  
  2700.  
  2701.           3.20.7  Save Setup
  2702.  
  2703.             This option saves the changes you made to the various
  2704.           configuration items to the file MYCOMM.CFG.  If you make changes,
  2705.           but do not save them, the changes will only remain active until
  2706.           you exit from MyComm.
  2707.  
  2708.  
  2709.           3.21 Send Screen to File - Alt W
  2710.  
  2711.             Pressing the <ALT> and the "W" key takes a "snap shot" of the
  2712.           currently displayed terminal screen and writes it out to the file
  2713.           MYCOMM.SCR.  The resulting file will contain the text currently
  2714.           on the screen.
  2715.  
  2716.  
  2717.           3.22 Exit MyComm - Alt X
  2718.  
  2719.             Pressing the <ALT> and the "X" key brings up a message box that
  2720.           takes a Yes/No response.  Press "Y" to exit MyComm, or "N" or
  2721.           <Esc> to cancel.
  2722.  
  2723.  
  2724.           3.23 Help Screen - F1
  2725.  
  2726.             When you are in the main terminal window pressing the F1 key
  2727.           will show you a list of MyComm commands that are available to
  2728.           you.
  2729.  
  2730.  
  2731.           MyComm Version 2.20 Documentation                    Page 49
  2732.  
  2733.  
  2734.  
  2735.           3.24 Send Name - F2
  2736.  
  2737.             When bulletin board systems answer your call they usually ask
  2738.           for your name and password.  This option sends the name that you
  2739.           log on with when you call a system if your name is filled in for
  2740.           the dialing directory entry for the system.
  2741.  
  2742.  
  2743.           3.25 Send Password - F3
  2744.  
  2745.             This option sends the password that you log on with when you
  2746.           call a system. See also "Send Name" above.
  2747.  
  2748.  
  2749.           3.26 Send Tagline  - F4
  2750.  
  2751.             This is used to sign your name, or put a short quote, up to 40
  2752.           characters at the end of a message.  This is set up in the
  2753.           "Miscellaneous Options Setup" screen.
  2754.  
  2755.  
  2756.           3.27 Transferring Files
  2757.  
  2758.             MyComm has a wide variety of built in file transfer protocols
  2759.           such as  Zmodem, Xmodem, Xmodem-1K, Ymodem Batch, Ymodem-G Batch,
  2760.           SEAlink, Kermit, and of course ASCII.  There are also slots to
  2761.           include up to six external file transfer protocols if you would
  2762.           like to add more.
  2763.  
  2764.              You may Upload (send) files or Download (receive) files.  Most
  2765.           host systems will have you start the file transfer at their end
  2766.           first, and then wait for you to set up on your end.  Host systems
  2767.           usually wait about a minute or so for you to set up, so don't
  2768.           panic.
  2769.  
  2770.             All file transfer protocols on MyComm use 8-N-1 (8 data bits,
  2771.           No parity, and 1 stop bit).  MyComm automatically sets these
  2772.           settings for you before the file transfer begins, then switches
  2773.           back to what ever settings were in place before the transfer
  2774.           began.
  2775.             Except for ASCII file transfers, MyComm turns off the XON/XOFF
  2776.           flow control switch if you have it set on.  This is done to
  2777.           prevent the XON/XOFF codes as being mistaken as part of the
  2778.           incoming file.  The original state of the XON/XOFF flow control
  2779.           is restored at the end of the file transfer.  If your modem has
  2780.           its own built in XON/XOFF flow control setting, you should turn
  2781.           it off during file transfers (refer to your modem manual -
  2782.           usually the &K option).
  2783.  
  2784.  
  2785.           MyComm Version 2.20 Documentation                    Page 50
  2786.  
  2787.  
  2788.  
  2789.             File transfers differ slightly from one host system to another.
  2790.           Basically you need to know three things:
  2791.  
  2792.                ■    whether you want to Upload (send) or Download (receive)
  2793.                     a file
  2794.  
  2795.                ■    the name of the file you want to send or receive
  2796.  
  2797.                ■    which file transfer protocol you want to use
  2798.  
  2799.             Probably you can figure out for yourself whether you are
  2800.           uploading or downloading from a system, and what the file name is
  2801.           that you want to transfer.  However you and the host system MUST
  2802.           use the same file transfer protocol or the transfer will fail.
  2803.           The tricky part sometimes is deciding which file transfer
  2804.           protocol to use.  There are so many!
  2805.  
  2806.             Actually it's easy to decide which file transfer protocol you
  2807.           want to use.  When you request a file transfer from the host
  2808.           system, they usually show you a list of file transfer protocols
  2809.           that their system supports.  Just pick one that both MyComm and
  2810.           the host system support, and you're on your way!
  2811.  
  2812.             The two most frequently used protocols are Xmodem and Zmodem.
  2813.           A little experimentation on your part will help you decide which
  2814.           of the file transfer protocols best meets your needs.
  2815.  
  2816.             A description of each of the file transfer protocols that
  2817.           MyComm supports will be found later in this section.
  2818.  
  2819.           3.27.1  Starting a File Transfer
  2820.  
  2821.             The steps to start the file transfer from your end with MyComm
  2822.           are simple:
  2823.  
  2824.                ■    Press PgUp to send files, or PgDn to receive files
  2825.  
  2826.                ■    Choose the file transfer protocol you want to use from
  2827.                     the menu
  2828.  
  2829.                ■    Type in the filename (if needed)
  2830.  
  2831.                ■    The file transfer will start and display a status
  2832.                     window
  2833.  
  2834.                ■    When the file transfer completes MyComm makes a noise
  2835.  
  2836.             MyComm's file transfer menus and screens look basically the
  2837.           same for both uploads and downloads.  When you press PgUp or PgDn
  2838.           a menu pops up showing you the different file transfer protocol
  2839.  
  2840.  
  2841.           MyComm Version 2.20 Documentation                    Page 51
  2842.  
  2843.  
  2844.  
  2845.           options you have (see example below).  Pick a protocol, or press
  2846.           the <Esc> or "Q" key to cancel.
  2847.  
  2848.           Download Protocol Menu Example
  2849.  
  2850.                                   +------| Down Load |+
  2851.                                   | ASCII             |
  2852.                                   | SEAlink Derived   |
  2853.                                   | Xmodem            |
  2854.                                   | 1K-Xmodem         |
  2855.                                   | Real Ymodem Batch |
  2856.                                   | Ymodem Batch - 1K |
  2857.                                   | Zmodem            |
  2858.                                   | Kermit            |
  2859.           external protocol ==>   | 1: BIGFAST        |
  2860.           (example)               | Quit/None         |
  2861.                                   +-------------------+
  2862.  
  2863.             After you pick a file transfer protocol, MyComm will ask you
  2864.           for the filename that you want to send or receive.  Some of the
  2865.           file transfer protocols for receiving files, such as Ymodem Batch
  2866.           and Zmodem, don't need to ask you the file name so you may not
  2867.           always be asked for a filename.  MyComm ALWAYS asks for the
  2868.           filename when you upload files.
  2869.  
  2870.           Note:
  2871.             When you upload files with the "batch" protocols you may also
  2872.           use the DOS "wildcard" characters for filenames such as *.* or
  2873.           ALL*.ARC, or FILE??.*, etc.
  2874.  
  2875.             If the filename, or the path to the file (the directory) are
  2876.           invalid or can't be found you will see an error message and you
  2877.           may re-enter the filename.  If you want to exit without
  2878.           performing the file transfer press the <Esc> key.
  2879.  
  2880.             When the filename is entered correctly MyComm will start the
  2881.           file transfer and the File Transfer Status Window shown below
  2882.           will pop up.
  2883.  
  2884.           Download/Upload Status Window
  2885.  
  2886.  
  2887.           MyComm Version 2.20 Documentation                    Page 52
  2888.  
  2889.  
  2890.  
  2891.  
  2892.           +------------------------------------------| Ymodem Download |+
  2893.           |                                                             |
  2894.           | Receiving: D:\PUBLIC\SOMEFILE.EXT                           |
  2895.           | ----------------------------------------------------------- |
  2896.           |                                                             |
  2897.           | Xfer Time:     0:04:18        Bytes Received:   14567       |
  2898.           | Elapsed Time:  0:01:18        Bytes Expected:   58645       |
  2899.           | Approx. CPS:       186        Blocks Sent:        114       |
  2900.           | ----------------------------------------------------------- |
  2901.           |                                                             |
  2902.           | Error Count: 0                Error Correction: CRC-16      |
  2903.           | Last Error Message: Receiving File                          |
  2904.           |                                                             |
  2905.           +-------------------------------------------------------------+
  2906.  
  2907.  
  2908.             The status window displays information about the file transfer
  2909.           such as the file name being sent/received, an estimate of how
  2910.           long it will take to do the transfer, the elapsed time, the CPS
  2911.           rate (Characters Per Second), the bytes sent/received, the blocks
  2912.           sent, error correction type, and error status.
  2913.  
  2914.           Note:
  2915.             Some protocols will not tell you the Xfer Time or the Bytes
  2916.           Expected during downloads.  This is because some protocols do not
  2917.           send an information "header" packet that tells MyComm how many
  2918.           bytes to expect from the sender.
  2919.  
  2920.             When MyComm calculates the amount of time a transfer will take
  2921.           it does the calculation based on a "worst case" rate of 80%
  2922.           efficiency. This is to take into consideration possible line
  2923.           noise, packet resends, and other considerations.  Actual file
  2924.           transfers may be faster than what MyComm calculates.
  2925.  
  2926.             The CPS rate reflects only the number of bytes actually
  2927.           sent/received from/to the file.  Overhead bytes such as CRC and
  2928.           "escape" characters are not included in the calculation.  This
  2929.           provides a more realistic picture of the file transfer progress.
  2930.  
  2931.  
  2932.           MyComm Version 2.20 Documentation                    Page 53
  2933.  
  2934.  
  2935.  
  2936.           3.27.2  File Transfer Hints
  2937.  
  2938.                ■    Both the sender and receiver MUST use the same file
  2939.                     transfer protocol
  2940.  
  2941.                ■    If a file transfer keeps aborting using one protocol on
  2942.                     a host system, try using a different one.
  2943.  
  2944.                ■    It is not a good idea to upload or download from floppy
  2945.                     disk.  Floppy drives are slow, so the read and write
  2946.                     access time will slow down the transfer.  Floppy drives
  2947.                     do not hold very much data.  If the floppy disk were to
  2948.                     fill up during a download, the transfer would be
  2949.                     aborted.
  2950.  
  2951.  
  2952.           3.27.3  Download Files - PgDn
  2953.  
  2954.               Pressing the PgDn (Page Down) key starts the file download
  2955.           procedures previously discussed.
  2956.  
  2957.  
  2958.           3.27.4  UpLoad Files - PgUp
  2959.  
  2960.               Pressing the PgUp (Page Up) key starts the file upload
  2961.           procedures previously discussed.
  2962.  
  2963.  
  2964.           3.27.5  ASCII File Transfers
  2965.  
  2966.             ASCII file transfers are only used to transfer text files.
  2967.           Program files, also known as binary files, should not be
  2968.           transferred as ASCII files.  ASCII uploads do not show the File
  2969.           Transfer Status Window unless you have set the "Show Upload"
  2970.           option to "No" in the ASCII Xfer configuration menu.  ASCII
  2971.           transfers have no error correction, but just plough along as
  2972.           though the characters were actually being typed from the
  2973.           keyboard.  This is commonly referred to as a "send and pray"
  2974.           protocol.
  2975.  
  2976.             During ASCII downloads, the download continues until either a
  2977.           Ctrl-Z (end of file marker) is received, or no characters have
  2978.           been received for 10 seconds.  You may also stop the transfer at
  2979.           any time by pressing the <ESC> key.
  2980.  
  2981.  
  2982.           MyComm Version 2.20 Documentation                    Page 54
  2983.  
  2984.  
  2985.  
  2986.           3.27.6  SEAlink Derived File Transfers
  2987.  
  2988.             SEAlink is an advanced version of Xmodem developed by System
  2989.           Enhancement Associates.  SEAlink uses a "sliding window" protocol
  2990.           which sends ahead several packets while waiting for an
  2991.           acknowledgement from the receiver.  This can result in transfers
  2992.           that are 10 to 20 percent faster than plain Xmodem.  SEAlink
  2993.           sends the file name and file size when the transfer starts up,
  2994.           and can be used to send more than one file at a time.
  2995.  
  2996.             The version of SEAlink that MyComm uses is known as "Derived
  2997.           SEAlink" as MyComm does not support the "overdrive" option which
  2998.           is only used in half-duplex links.
  2999.  
  3000.  
  3001.           3.27.7  Xmodem File Transfers
  3002.  
  3003.             Xmodem is probably the most widely used protocol today.  Xmodem
  3004.           was originally developed by Ward Christensen in the summer of
  3005.           1977 for use on CP/M machines, and was soon ported to the MS-DOS
  3006.           environment.  Xmodem sends data in 128 byte blocks.  The block
  3007.           count seen in the File Transfer Status Window shows the number of
  3008.           128 byte blocks that have been transferred.  This has
  3009.           euphemistically been called "Xmodem blocks" and has become
  3010.           somewhat of a standard in P.C. data communications.
  3011.  
  3012.             Xmodem has two flavors; Check Sum and CRC-16 mode.  MyComm
  3013.           supports both Check Sum and CRC-16 mode, and automatically
  3014.           selects the correct one to use.  The check sum mode is not nearly
  3015.           as reliable as CRC-16, and isn't used as often.
  3016.  
  3017.           3.27.8  1K-Xmodem File Transfers
  3018.  
  3019.             Xmodem-1K is a variation of Xmodem which uses a 1K (1024 byte)
  3020.           block to send data.  Under most conditions Xmodem-1K is slightly
  3021.           faster than plain Xmodem.  If there is a lot of line noise
  3022.           however, the throughput can degrade due to having to perform a
  3023.           resend on the larger packet.
  3024.  
  3025.             Some older host systems may refer to Xmodem-1K as "Ymodem" so
  3026.           read the host system menu carefully.
  3027.  
  3028.  
  3029.           MyComm Version 2.20 Documentation                    Page 55
  3030.  
  3031.  
  3032.  
  3033.           3.27.9  Ymodem Batch File Transfers
  3034.  
  3035.             The Ymodem Batch protocol can perform either single or batch
  3036.           file transfers.  That is, it can send or receive one or more
  3037.           files in a transfer session.  Ymodem Batch starts sessions by
  3038.           sending the file name and size to the receiver, then sends the
  3039.           file data.  Ymodem uses both a 128 byte or 1024 byte (1K) packet
  3040.           size and MyComm chooses the correct packet size to use during the
  3041.           transfer.
  3042.  
  3043.  
  3044.           3.27.10  Ymodem-G Batch File Transfers
  3045.  
  3046.             The Ymodem-G Batch protocol is similar to the regular Ymodem
  3047.           Batch protocol. The difference is that Ymodem-G performs no error
  3048.           correction what-so-ever and as such it is generally only used
  3049.           with error correcting modems, or Null modem cables.  If an error
  3050.           is detected during a transfer, the transfer is immediately
  3051.           aborted.
  3052.  
  3053.  
  3054.            3.27.11 Zmodem File Transfers
  3055.  
  3056.             Zmodem is another widely used file transfer protocol.  It was
  3057.           developed by Chuck Forsberg/Omen Technology, Inc.  Zmodem is an
  3058.           extremely robust protocol as it recovers from errors well and
  3059.           will try to keep the file transfer session going under adverse
  3060.           conditions.
  3061.  
  3062.             Zmodem will perform both single file and batch (multiple) file
  3063.           transfers.  Like Ymodem, when receiving a file using Zmodem, you
  3064.           don't have to type in the file name on your end.  Zmodem sends
  3065.           the filename as part of a special "header" that MyComm
  3066.           recognizes.
  3067.  
  3068.             Zmodem uses either a 16 bit or 32 bit CRC (Cyclic Redundancy
  3069.           Check) when transferring the file.  You will see the CRC type
  3070.           displayed in the File Transfer Status Window.  The CRC is used
  3071.           for error checking during the transfer.  MyComm automatically
  3072.           selects the proper CRC type to use so you don't have to worry
  3073.           about it.  The 16 bit CRC transfers often go a little faster than
  3074.           32 bit CRC transfers.  However the 32 bit CRC is much more
  3075.           reliable for error correction, and well worth the few seconds
  3076.           added to the transfer time.
  3077.  
  3078.  
  3079.           MyComm Version 2.20 Documentation                    Page 56
  3080.  
  3081.  
  3082.  
  3083.            3.27.12 Kermit File Transfers
  3084.  
  3085.             The Kermit file transfer protocol is widely used in many
  3086.           environments in particular mainframes and mini mainframes.
  3087.           Kermit was designed to allow many different types of machines to
  3088.           send data to each other.  In order to do this Kermit places a
  3089.           special "escape" character before any control characters
  3090.           encountered.  However this compatibility does have its price,
  3091.           Kermit is one of the slowest protocols in use today.  Because of
  3092.           the slow file transfers Kermit should be used when there is no
  3093.           other protocol available.  The Kermit version in MyComm supports
  3094.           the "basic" Kermit protocol.
  3095.  
  3096.  
  3097.           3.27.13 External Protocol File Transfers
  3098.  
  3099.               MyComm lets you define up to six external file transfer
  3100.           protocols.  The external file transfer protocols will also appear
  3101.           in the Upload and Download protocol selection menus.
  3102.  
  3103.             External protocols are set up in the External Protocols Setup
  3104.           (see section 3.20.3.3 "External Protocols Setup").  External
  3105.           protocols differ from vendor to vendor, so you should refer to
  3106.           the particular protocol's documentation for more detailed
  3107.           installation instructions.  MyComm invokes the external protocols
  3108.           through the use of DOS "batch" files.  Parameters are passed to
  3109.           the batch file in the following order: COM Port number (0 to 7),
  3110.           BPS rate, and Drive:\Path\Filename which translate to batch
  3111.           parameters %1, %2, and %3.
  3112.  
  3113.  
  3114.           3.27.14 MyComm as a Host
  3115.  
  3116.             At this point in time MyComm does not have a "host" mode per
  3117.           Se.  This was a design decision in order to keep the code size
  3118.           small. However, there is a file called MCHOST.SCP which is a
  3119.           MyComm script that will perform very simple host functions.  The
  3120.           MCHOST.SCP file may be used as an example to create your own host
  3121.           scripts as well. Please note that MyComm is not intended for use
  3122.           as a BBS, but the MCHOST.SCP should provide enough functionality
  3123.           for simple file transfers.  See also Appendix E - Script
  3124.           Language.
  3125.  
  3126.             It is also possible to transfer files between two MyComm
  3127.           programs (or MyComm and another communication program) without
  3128.           the use of a special script file.  To do this one person acts as
  3129.           the "host", and the other as caller.  As the caller you would
  3130.           just call the other person as you would for any other bulletin
  3131.           board system.
  3132.  
  3133.  
  3134.           MyComm Version 2.20 Documentation                    Page 57
  3135.  
  3136.  
  3137.  
  3138.           For this example, let's say you're the host since that's the
  3139.           complicated part.
  3140.  
  3141.           Step 1:   Prearrange a time for the other person to call you.
  3142.  
  3143.           Step 2:   Get MyComm up and running.
  3144.  
  3145.           Step 3:   When the other person calls you will hear the phone
  3146.                     ringing or see the word "RING" appear on the MyComm
  3147.                     terminal screen.  When you see "RING", type ATA then
  3148.                     press the <Enter> key.  This tells your modem to answer
  3149.                     the phone and initiate the carrier tones so the two
  3150.                     modems will "talk" to each other.  Alternatively you
  3151.                     could press <Alt> and the "I" key, then press "A" for
  3152.                     the "Send Answer String" command.
  3153.  
  3154.           Step 3a:  Alternative to Step 3: before the other person calls
  3155.                     type ATS0=1 then press <Enter>.  This tells your modem
  3156.                     to answer the modem on the first ring and to initiate
  3157.                     the carrier tones.
  3158.  
  3159.           Step 4:   When transferring files from one MyComm to another
  3160.                     remember that when they are uploading, you are
  3161.                     downloading and vice versa.  So if the other person
  3162.                     wants to download a file from you they would start the
  3163.                     download function at their end, and you would start an
  3164.                     upload from your end.  The most important things to
  3165.                     decide before doing the transfer are:
  3166.  
  3167.                       - who is uploading/downloading to and from who
  3168.  
  3169.                       - which file transfer protocol you are using (they
  3170.                         MUST be the same)
  3171.  
  3172.                       - and finally, what the filename is.
  3173.  
  3174.           Step 4a   This is where the MyComm "chat" mode can be handy.  It
  3175.                     can help you establish stuff while you're on-line with
  3176.                     the other person.  If you would like to "chat" on-line
  3177.                     with the other person, Press <Alt> and the "A" key to
  3178.                     bring up the MyComm split screen chat mode (see section
  3179.                     3.3 "Chat Mode").
  3180.  
  3181.           Step 5:   If all goes smoothly the file transfer will be
  3182.                     successful.  In fact for the most part it will be as
  3183.                     though you had simply called another BBS, except this
  3184.                     time you're interacting with a live person rather than
  3185.                     the BBS software.
  3186.  
  3187.  
  3188.  
  3189.  
  3190.  
  3191.  
  3192.           Appendix A - MyComm Command Summary
  3193.  
  3194.                     Alt A - Chat Mode
  3195.                     Alt B - Send Break
  3196.                     Alt C - Clear the Screen
  3197.                     Alt D - Dialing Functions
  3198.                     Alt E - Local Echo On/Off
  3199.                     Alt H - Hang Up Modem
  3200.                     Alt I - Send Modem Initialization Strings
  3201.                     Alt J - Join Script (Run a Script)
  3202.                     Alt L - Present Line Status
  3203.                     Alt K - Scroll Back
  3204.                     Alt M - Manual Dial
  3205.                     Alt O - Outside to DOS
  3206.                     Alt P - Change Port Parameters
  3207.                     Alt Q - Quick Re- Dial
  3208.                     Alt R - Run External Program
  3209.                     Alt S - Session Capture On/Off/Pause
  3210.                     Alt T - Terminal Emulation
  3211.                     Alt U - Update Configuration
  3212.                     Alt W - Send Screen to File
  3213.                     Alt X - Exit MyComm
  3214.  
  3215.                     F1    - Help Screen
  3216.                     F2    - Send Name
  3217.                     F3    - Send Password
  3218.                     F4    - Send Tagline
  3219.  
  3220.                     PgUp  - Upload Files
  3221.                     PgDn  - Download Files
  3222.  
  3223.  
  3224.  
  3225.  
  3226.  
  3227.  
  3228.           Appendix B - MyComm Line Editing Functions
  3229.  
  3230.             Many of the user configuration options and the dialing list
  3231.           have sections that require a line of text to be input and edited.
  3232.           MyComm has a built in line editor to perform simple editing on
  3233.           these text lines.  The MyComm line editor uses a tiny subset of
  3234.           WordStar type commands.  A description of the line edit commands
  3235.           follows.
  3236.  
  3237.           ■ Enter       -     Terminates editing the line and keeps it
  3238.  
  3239.           ■ Esc         -     Terminates editing the line and does not keep
  3240.                               it
  3241.  
  3242.           ■ Right Arrow -     Moves the cursor right.
  3243.  
  3244.           ■ Left Arrow  -     Moves the cursor left.  This is "non-
  3245.                               destructive", the character is not erased as
  3246.                               the cursor moves
  3247.  
  3248.           ■ BackSpace   -     Moves the cursor left.  This is
  3249.                               "destructive", the character is erased as the
  3250.                               cursor moves
  3251.  
  3252.           ■ End         -     Positions the cursor at the end of the line
  3253.  
  3254.           ■ Home        -     Positions the cursor at the beginning of the
  3255.                               line
  3256.  
  3257.           ■ Ctrl + T    -     When the Ctrl key and the letter T are
  3258.                               pressed simultaneously, the line is erased
  3259.                               from the current cursor position to the end
  3260.                               of the line
  3261.  
  3262.           ■ Ctrl + Y    -     When the Ctrl key and the letter Y are
  3263.                               pressed simultaneously, the entire line is
  3264.                               erased and the cursor is positioned at column
  3265.                               one
  3266.  
  3267.  
  3268.  
  3269.  
  3270.  
  3271.  
  3272.           Appendix C - Terminal Emulation
  3273.  
  3274.             This is a list of the functions that MyComm supports in the
  3275.           terminal emulators.
  3276.  
  3277.           TTY Terminal Emulation
  3278.  
  3279.             TTY does not provide any character translation what-so-ever.
  3280.           The characters are simply displayed as they come in.
  3281.  
  3282.  
  3283.           ANSI Terminal Emulation
  3284.  
  3285.  
  3286.             ANSI provides mapping similar to that found in your ANSI.SYS
  3287.           driver.  The color and screen attributes as described in the
  3288.           "MS-DOS 5.0 User's Guide and Reference" are supported, except for
  3289.           the keyboard mapping functions.  The following keys also generate
  3290.           codes recognized by other systems operating in ANSI mode:
  3291.  
  3292.             Direction (Arrow) Keys  - move cursor
  3293.             Delete                  - sends DEL (127 decimal)
  3294.             End                     - erase to end of line
  3295.             Home                    - homes cursor
  3296.             Ctrl-Home               - clears screen, and homes cursor
  3297.             Function Keys           - do not generate a character
  3298.  
  3299.  
  3300.  
  3301.  
  3302.  
  3303.  
  3304.           VT-52 and VT-100 Terminal Emulation
  3305.  
  3306.  
  3307.  
  3308.             The VT-52 and VT-100 emulations are typically used with
  3309.           mainframe environments.  These emulations provide a subset of the
  3310.           "application keyboard" functions defined in the "VT-200
  3311.           Programmer Guide", Digital #EK-VT220-HR-001.  These emulations
  3312.           will work in either a 7 or 8 bit environment.  A standard key pad
  3313.           for these terminals looks like this:
  3314.  
  3315.               +-----------------------+
  3316.               | PF1 | PF2 | PF3 | PF4 |
  3317.               |-----+-----+-----+-----|
  3318.               |  7  |  8  |  9  |  -  |
  3319.               |-----+-----+-----+-----|
  3320.               |  4  |  5  |  6  |  ,  |
  3321.               |-----+-----+-----+-----|
  3322.               |  1  |  2  |  3  |  R  |
  3323.               |-----------+-----|  T  |
  3324.               |     0     |  .  |  N  |
  3325.               +-----------------------+
  3326.  
  3327.             MyComm defines these keys as follows:
  3328.  
  3329.             PF1 through PF4     - <SHIFT> + F1 through F4
  3330.             1 through 0         - <ALT> + F1 through F10
  3331.             Minus Sign "-"      - <SHIFT> + F5
  3332.             Comma ","           - <SHIFT> + F6
  3333.             Decimal Point "."   - <SHIFT> + F7
  3334.             RTN (Enter key)     - <SHIFT> + F8
  3335.  
  3336.           NOTE: the above keys are the function keys on a standard PC
  3337.           keyboard.  The PC numeric keypad has not been mapped to these
  3338.           keys.
  3339.           Also defined:
  3340.  
  3341.             Direction (Arrow) Keys  - move cursor
  3342.             Delete                  - sends DEL (127 decimal)
  3343.             End                     - erase to end of line
  3344.             Home                    - homes cursor
  3345.             Ctrl-Home               - clears screen, and homes cursor
  3346.  
  3347.  
  3348.  
  3349.  
  3350.  
  3351.  
  3352.           3270 Terminal Emulation (Registered version only)
  3353.  
  3354.  
  3355.             This emulation is most commonly used when connecting to IBM
  3356.           mainframe hosts.  This emulation should be used instead of VT-100
  3357.           emulation when connecting through the 7171 protocol converter.
  3358.           This emulation works best with 101 key PC keyboards (to get the
  3359.           PF11, PF12, PF23, and PF24 keys).  The mapping to the PC keyboard
  3360.           follows.
  3361.  
  3362.           PC Keypad         Alternate            3270 emulation
  3363.  
  3364.           <Shift> + F1                           PF1
  3365.              ...                                 ...
  3366.              ...                                 ...
  3367.           <Shift> + F10                          PF10
  3368.           <Shift> + F11    <Esc> + -             PF11
  3369.           <Shift> + F12    <Esc> + =             PF12
  3370.  
  3371.           <Alt> + F1                             PF13
  3372.              ...                                 ...
  3373.              ...                                 ...
  3374.           <Alt> + F10                            PF22
  3375.           <Alt> + F11      <Esc> + _             PF23
  3376.           <Alt> + F12      <Esc> + +             PF24
  3377.  
  3378.           <Ctrl> + F1                            PA1
  3379.              ...                                 ...
  3380.              ...                                 ...
  3381.           <Ctrl> + F4                            PA4
  3382.  
  3383.           Arrow Keys                         Arrow Keys
  3384.           Insert                             Toggle Insert
  3385.           <Shift> + <Tab>                    Back Tab
  3386.           <Ctrl> + <Left Arrow>              BackSpace
  3387.           Home                               Home
  3388.           Delete                             DEL
  3389.           <Ctrl> + Home                      CLEAR
  3390.           End                                Erase to End of field
  3391.           <Ctrl> + End                       Line Feed
  3392.  
  3393.  
  3394.  
  3395.  
  3396.  
  3397.  
  3398.           Appendix D - Troubleshooting
  3399.           This section should answer common problems that you might have
  3400.           when using MyComm.
  3401.  
  3402.           Problem:
  3403.  
  3404.             - Modem doesn't respond.
  3405.  
  3406.           Possible Causes:
  3407.  
  3408.             -  Is the COM port the right one?  i.e COM 1, 2, 3, 4, 5, 6, 7,
  3409.                or 8.
  3410.  
  3411.             -  Is the modem installed correctly?
  3412.             -  Is the modem really Hayes (Tm) compatible?
  3413.  
  3414.             -  If this is an external modem, are the cables hooked up?
  3415.                Is it plugged in?
  3416.  
  3417.             -  MyComm uses default address and interrupt vectors for COM
  3418.                Ports of:
  3419.  
  3420.                COM Port   Address  IRQ Line
  3421.                   1        3F8        4
  3422.                   2        2F8        3
  3423.                   3        3E8        4
  3424.                   4        2F8        3
  3425.                   5        3E8        2
  3426.                   6        2F8        2
  3427.                   7        3E8        5
  3428.                   8        2F8        5
  3429.  
  3430.                If you have set these to something different, MyComm
  3431.           probably won't like it.  Reset the interrupt vectors to their
  3432.           standard settings.  If you don't know what this means, you
  3433.           probably didn't fool with it in the first place, so don't mess
  3434.           with it now.
  3435.  
  3436.             MyComm allows user configuration of addresses or interrupt
  3437.           vectors on the COM ports.  See the section "COM Port Addresses"
  3438.           for more information.
  3439.  
  3440.  
  3441.  
  3442.  
  3443.  
  3444.  
  3445.           Problem:
  3446.  
  3447.             - Modem won't hang up the phone line.
  3448.  
  3449.           Possible Causes:
  3450.  
  3451.             -  Some modems have a DIP switch setting that keeps Carrier
  3452.                Detect always on.  MyComm uses the Carrier Detect signal
  3453.                (CD) to see if it's on-line, and to see when the modem has
  3454.                released the phone line.  You should set your modem to let
  3455.                software, in this case MyComm, to handle the Carrier Detect
  3456.                signal.
  3457.  
  3458.             -  Try adding the Hayes command &C1 to your initialization
  3459.                string.  This tells the modem to raise Carrier Detect only
  3460.                when connected.
  3461.  
  3462.           Problem:
  3463.  
  3464.             - Modem dials, but doesn't know when the connection is made.
  3465.  
  3466.           Probable Causes:
  3467.  
  3468.             -  Make certain that the modem is sending text responses rather
  3469.                than numeric.  Add "Q0" and "V1" to your modem
  3470.                initialization string.
  3471.  
  3472.             -  Go into the "Modem Setup" screen and check the "Connect
  3473.                Strings" setting.  Make sure that they look like the ones
  3474.                your modem usually generates.
  3475.  
  3476.           Problem:
  3477.  
  3478.             -  The result codes from the modem are numbers instead of
  3479.                text.
  3480.  
  3481.           Possible Causes:
  3482.  
  3483.             -  Try adding Q0 and V1 to the modem initialization string.
  3484.                MyComm MUST see the result codes, and they have to be the
  3485.                English Text.  Also try adding X4 to the initialization
  3486.                string.
  3487.  
  3488.           Problem:
  3489.  
  3490.             -  When using a multitasker such as Windows (Tm), DoubleDOS
  3491.                (Tm), etc, the MyComm displays bleed through to other
  3492.                applications.
  3493.  
  3494.           Possible Causes:
  3495.  
  3496.             -  Set the option in the Miscellaneous Options Screen named
  3497.                "Direct Screen Writes" to "No".
  3498.  
  3499.  
  3500.  
  3501.  
  3502.  
  3503.  
  3504.           Problem:
  3505.  
  3506.             -  When I call some services, the characters look weird, or
  3507.                just garbage.
  3508.  
  3509.           Possible Causes:
  3510.  
  3511.             -  Make sure that the Baud Rate, Data Bits, etc. are set
  3512.                correctly. Most public BBS's use 8-N-1, but some may use 7-
  3513.                E-1 (often true with Unix (Tm) based systems and
  3514.                mainframes).
  3515.  
  3516.             -  Are you using the correct terminal emulation? See <ALT> +T
  3517.                command.
  3518.  
  3519.             -  This is sometimes caused by a COM port or IRQ line conflict.
  3520.                If another serial card or device is on the same COM port or
  3521.                IRQ line you may experience dropped characters, weird things
  3522.                happening during file transfers and other problems. See also
  3523.                question # 1 above.
  3524.  
  3525.           Problem:
  3526.  
  3527.             -  File transfers seem to always time out or abort.
  3528.  
  3529.           Possible Causes:
  3530.  
  3531.             -  MyComm will abort a transfer if there are too many errors in
  3532.                the transfer due to line noise, or other unpredictable
  3533.                circumstances.
  3534.  
  3535.             -  Are you and the other guy are using the same file transfer
  3536.                protocol?
  3537.  
  3538.  
  3539.  
  3540.  
  3541.  
  3542.  
  3543.           Appendix E - MyComm Script Language
  3544.  
  3545.           1.0  Script Language Introduction
  3546.  
  3547.               This Appendix describes the format and syntax of the script
  3548.           language used by MyComm.  The MyComm script language is a series
  3549.           of commands in a text file that is read by MyComm to perform
  3550.           certain functions.  For example, a script function could send
  3551.           your name and password automatically when you log onto a system,
  3552.           then perform steps to navigate through the host system menus to
  3553.           gather your mail for you and then log off.
  3554.  
  3555.             The script language used in MyComm consists of 22 commands that
  3556.           are used to build scripts.  The script language is very simple,
  3557.           yet very powerful.  It is designed in such a way that ordinary
  3558.           people rather than programmers or technicians will find it easy
  3559.           to use and understand.  MyComm's script language should be no
  3560.           more difficult to use than writing DOS batch files.
  3561.  
  3562.  
  3563.           1.2  Creating a Script
  3564.  
  3565.             Scripts are created using a line editor, text editor, or word
  3566.           processing software that can save files as plain unformatted
  3567.           text.  It is similar to creating DOS "batch" files.
  3568.  
  3569.           To Create a Script
  3570.  
  3571.           Step 1:   Log onto the BBS or system that you want to create a
  3572.                     script for.  As you log on write down the sequence of
  3573.                     questions and responses that you receive and send.  For
  3574.                     example if the host system has a prompt that says
  3575.                     "Enter your Name:" and you type in your name at that
  3576.                     point, write down the question asked by the host system
  3577.                     and your response.  Optionally you may turn on the
  3578.                     Session Capture (ALT + "S") to save your responses for
  3579.                     later referral.
  3580.  
  3581.  
  3582.           Step 2:   Log off the BBS or system. No sense in tying up their
  3583.                     line.
  3584.  
  3585.           Step 3:   Use your text editor to write the script file.  The
  3586.                     script commands that MyComm understands are described
  3587.                     later in this Appendix.  The script file must be saved
  3588.                     to the same directory that the MyComm program is in
  3589.                     (for example C:\MYCOMM) so that MyComm can find it
  3590.                     later.
  3591.  
  3592.           Step 4:   Test your script with the MyComm Script Checker,
  3593.                     SCP_CHK.EXE (described later in this Appendix).  Revise
  3594.                     the script and re-test as necessary.
  3595.  
  3596.  
  3597.  
  3598.  
  3599.  
  3600.  
  3601.           Step 5:   Go to the Dialing Directory and edit the dialing entry
  3602.                     for this BBS.  There is an option called "Scripts".
  3603.                     Add the name of your script file here.
  3604.  
  3605.           Step 6:   Call the BBS and test your script.  Sometimes it may
  3606.                     take more than one try to get it all right.  Don't
  3607.                     worry, it happens to us all.
  3608.  
  3609.           2.0  Script Language
  3610.  
  3611.             The MyComm script language consists of 22 commands which will
  3612.           be described shortly.  The script files that you create must have
  3613.           the file name extension .SCP, and must be saved in the same
  3614.           directory that MyComm is in.  For example if you created a script
  3615.           for MyBbs, the script file would be named MYBBS.SCP.
  3616.  
  3617.             This manual will use the following conventions to describe the
  3618.           functions and the parameters that they take:
  3619.  
  3620.                FUNCNAME()     Function name is all CAPS. Please note that
  3621.                               no function name is over eight characters
  3622.                               long. All functions have the parameters
  3623.                               enclosed with parenthesis.  The parameters
  3624.                               are separated with commas.
  3625.  
  3626.                <int>          Integer parameter.
  3627.  
  3628.                <"string">     String parameter.  Please note that all
  3629.                               incoming and outgoing strings may be a
  3630.                               maximum of 60 characters in length.  Strings
  3631.                               are case sensitive, "PassWord" and "password"
  3632.                               are different strings!  Also note that the
  3633.                               strings are enclosed in quotes.  Since commas
  3634.                               are used as parameter delimiters, strings
  3635.                               must not contain embedded commas!
  3636.  
  3637.                <op1|op2|...>  Operator parameter.  Some functions use an
  3638.                               operator.
  3639.  
  3640.                <"label">      Label name.
  3641.  
  3642.                <Sn>           Parameter may be one of the string flags S0
  3643.                               through S9.
  3644.  
  3645.                <In>           Parameter may be one of the integer flags I0
  3646.                               through I9.
  3647.  
  3648.                (optional)     Indicates the next parameter is optional
  3649.  
  3650.                <"string"|Sn>  Parameter may either be a string constant or
  3651.                               one of the string flags.
  3652.  
  3653.  
  3654.  
  3655.  
  3656.  
  3657.  
  3658.  
  3659.                :label         Label within the script file.  All labels are
  3660.                               preceded by a colon ':' character.  Labels
  3661.                               may be up to eight (8) characters.
  3662.  
  3663.                comments       Comments are preceded by a semi-colon ';'.
  3664.                               The comments are free form and may be placed
  3665.                               anywhere.  The rest of the line after the
  3666.                               semi-colon is ignored by the script.
  3667.  
  3668.             The script functions are described in the following sections.
  3669.           The format of the descriptions is the function name, the
  3670.           parameter it takes, and a description. For example:
  3671.  
  3672.                WAITFOR(int waitsecs, "string"|Sn, (optional) "label"|Sn)
  3673.  
  3674.           indicates that the WAITFOR function takes an integer parameter, a
  3675.           string or "S" flag parameter, and an optional string or "S" flag
  3676.           parameter.
  3677.           2.1  Special Script Characters
  3678.  
  3679.             There are several special characters that MyComm will interpret
  3680.           for you when they are put into strings that you are sending to
  3681.           the host system:
  3682.  
  3683.           ^M ("caret" sign and capital "M")       This character sequence
  3684.                                                   sends a "carriage
  3685.                                                   return", as though you
  3686.                                                   had pressed <Enter> on
  3687.                                                   the keyboard.
  3688.  
  3689.           ^[ ("caret" sign and left bracket "[")  This character sequence
  3690.                                                   sends <Esc> as though you
  3691.                                                   had pressed <Esc> on the
  3692.                                                   keyboard.
  3693.  
  3694.           ~ (tilde) -                             This character causes a
  3695.                                                   100 millisecond delay.
  3696.           2.2  Script Functions
  3697.  
  3698.             The next section describes the various script functions that
  3699.           are available.
  3700.  
  3701.  
  3702.           2.2.1  Labels
  3703.  
  3704.             Labels are used to produce logical execution branches within
  3705.           the script file.  Labels are used with the GOTO(<label>) function
  3706.           as well as several other functions which will branch when a
  3707.           condition is met.
  3708.  
  3709.  
  3710.  
  3711.  
  3712.  
  3713.  
  3714.           2.2.2  WAITFOR()
  3715.  
  3716.           format: WAITFOR(int waitsecs, "string"|Sn, (optional) "label"|Sn)
  3717.  
  3718.           WAITFOR() will wait up to <int> seconds for <string> and goto
  3719.           <label> if the <string> is received.  If the <string> is not
  3720.           received the next line in the script is executed.  Note that
  3721.           <label> is optional in which case the next line in the script
  3722.           would be executed regardless.
  3723.  
  3724.           For example if you wanted to wait 30 seconds for the string
  3725.           "PassWord" then jump to the label :GotPass
  3726.  
  3727.                WAITFOR(30, "PassWord", "GotPass")
  3728.  
  3729.           would do it.
  3730.  
  3731.  
  3732.           2.2.3  XMIT()
  3733.  
  3734.           format: XMIT("string"|Sn)
  3735.  
  3736.           Transmit a "string".  For example:
  3737.  
  3738.                XMIT("password")
  3739.  
  3740.           would send the string "password".
  3741.             If the LOCLECHO() function has been set to "Yes" the characters
  3742.           sent by XMIT() will also be shown on your local screen.  This may
  3743.           be useful when the other system is not echoing characters back to
  3744.           you.
  3745.  
  3746.  
  3747.           2.2.4  GOTO()
  3748.  
  3749.           format: GOTO("label"|Sn)
  3750.  
  3751.           Jump to :label.  For example, if you have the label ":Lab001" in
  3752.           your script, GOTO("Lab001") would jump to that label.  Script
  3753.           execution resumes at the line after the label.
  3754.  
  3755.  
  3756.           2.2.5  SETFLAG()
  3757.  
  3758.           format: SETFLAG(In, int value)
  3759.  
  3760.           Set integer flag to a value.  The flags are referenced as flag 0
  3761.           through 9.  The flags can take on values between -999 and 9999.
  3762.           This function has the following format:
  3763.  
  3764.           For example to set flag 1 to 42:
  3765.  
  3766.                SETFLAG(I1, 42)
  3767.  
  3768.  
  3769.  
  3770.  
  3771.  
  3772.  
  3773.  
  3774.           2.2.6  INCFLAG()
  3775.  
  3776.           format: INCFLAG(In)
  3777.  
  3778.             The flags that were set (see SETFLAG() above) may be
  3779.           incremented by 1.  To increment flag 1:
  3780.  
  3781.                INCFLAG(I1)
  3782.  
  3783.  
  3784.           2.2.7  DECFLAG()
  3785.  
  3786.           format: DECFLAG(In)
  3787.  
  3788.             The flags that were set (see SETFLAG() above) may be
  3789.           decremented by 1.  To decrement flag 1:
  3790.  
  3791.                DECFLAG(I1)
  3792.  
  3793.  
  3794.           2.2.8  IFFLAG()
  3795.  
  3796.           format: IFFLAG(In, <EQ|GT|LT|GE|LE|NE>, int value, "label"|Sn)
  3797.  
  3798.             The integer flags may be tested for logical conditions.  If the
  3799.           condition is met script execution continues at the statement
  3800.           following the label.  The test condition operators are:
  3801.  
  3802.                EQ - equal
  3803.                GT - greater than
  3804.                LT - less than
  3805.                GE - greater than or equal
  3806.                LE - less than or equal
  3807.                NE - not equal
  3808.  
  3809.           If you wanted to test to see if flag 1 was EQual to 42, then jump
  3810.           to label :Lab001 you would enter:
  3811.  
  3812.                IFFLAG(I1, EQ, 42, "Lab001")
  3813.  
  3814.           NOTE: Quote characters are not used around the operators.
  3815.  
  3816.  
  3817.           2.2.9  IFSCAN()
  3818.  
  3819.           format: IFSCAN(Sn, "string"|Sn, "label"|Sn)
  3820.  
  3821.             You may set up to ten scan strings to continuously scan for.
  3822.           When the scan condition is met script execution continues at the
  3823.           statement following the label.  For example if you wanted to scan
  3824.           for the string "John Doe" and then jump to the label :Lab001 when
  3825.           it was found:
  3826.  
  3827.  
  3828.  
  3829.  
  3830.  
  3831.  
  3832.  
  3833.                IFSCAN(S1, "John Doe", "Lab001")
  3834.  
  3835.           IFSCAN() recognizes S0 through S9 as valid flag names.  The
  3836.           IFSCAN() function can be reset to scan for a new string by re-
  3837.           using the string variable. For example:
  3838.  
  3839.                IFSCAN(S1, "Bob Public", "Lab001")
  3840.  
  3841.  
  3842.           2.2.10 SENDNAME()
  3843.  
  3844.           format: SENDNAME()
  3845.  
  3846.             The SENDNAME() function will send the name that you have
  3847.           defined in your dialing directory entry for the BBS that the
  3848.           script is "Joined" to.  SENDNAME() take no parameters.  If the
  3849.           name entry in the dialing directory is blank nothing is sent.
  3850.  
  3851.  
  3852.           2.2.11 SENDPASS()
  3853.  
  3854.           format: SENDPASS()
  3855.             The SENDPASS() function will send the password that you have
  3856.           defined in the dialing directory entry for the BBS that the
  3857.           script is "Joined" to.  SENDPASS() take no parameters.  If the
  3858.           password entry in the dialing directory is blank nothing is sent.
  3859.  
  3860.  
  3861.           2.2.12 SENDFILE()
  3862.  
  3863.           format: SENDFILE(<op> A|S|X|K|Y|G|Z, "filename"|Sn,
  3864.                   optional "path"|Sn)
  3865.  
  3866.             The SENDFILE() function is used to upload a file to the host
  3867.           system.  You will have to take care of any preparatory steps
  3868.           within the script, such as telling the host that you are sending
  3869.           a file.
  3870.  
  3871.             The parameters are a one letter designator for the protocol,
  3872.           and a "string" or string flag (S0..S9) for the filename.  By
  3873.           default MyComm looks for the file that you are sending in the
  3874.           "Upload Directory" that you have defined in MyComm.  You may
  3875.           specify a different directory path as the third parameter.
  3876.  
  3877.  
  3878.  
  3879.  
  3880.  
  3881.  
  3882.  
  3883.             The valid operators for <op> are:
  3884.  
  3885.                A - ASCII
  3886.                S - SEAlink
  3887.                X - Xmodem
  3888.                K - Xmodem-1K
  3889.                Y - Ymodem Batch
  3890.                G - Ymodem-G
  3891.                R - Kermit
  3892.                Z - Zmodem
  3893.  
  3894.           For example if you wanted to send the file "MYCOMM.ARC" using
  3895.           Zmodem:
  3896.  
  3897.                SENDFILE(Z, "MyComm.ARC")
  3898.                          - or -
  3899.                SENDFILE(Z, "MyComm.ARC", "MYPATH")
  3900.  
  3901.  
  3902.           2.2.13 RECVFILE()
  3903.  
  3904.           format: RECVFILE(<op> A|S|X|K|Y|G|Z, optional "filename"|Sn,     
  3905.                   optional "path"|Sn)
  3906.  
  3907.             RECVFILE() allows you to receive files from the host system.
  3908.           You will have to take care of any preparatory steps within the
  3909.           script, such as telling the host that you want to receive a file.
  3910.  
  3911.           See SENDFILE() (above) for the list of valid operators.  By
  3912.           default the received files are put into the "Download" directory
  3913.           defined in MyComm, however files may be put into a different
  3914.           directory by using the third optional parameter.
  3915.  
  3916.           For example if you wanted to download the file "STUFF.ARC" using
  3917.           Xmodem:
  3918.  
  3919.                RECVFILE(X, STUFF.ARC)
  3920.                          - or -
  3921.                RECVFILE(X, "MyComm.ARC", "MYPATH")
  3922.  
  3923.           Please note that SEAlink, Ymodem, Ymodem-G, and Zmodem do not
  3924.           require that a filename be specified.  These protocols send the
  3925.           filename in a special header.  The ASCII, Xmodem, and Xmodem-1K
  3926.           protocols always require that a filename is specified.
  3927.  
  3928.             NOTE: if you have the Zmodem "Auto Download" feature turned on
  3929.           there may be conflicts between the script Zmodem and the MyComm
  3930.           Zmodem.  If you have the Zmodem "Auto Download" feature turned on
  3931.           in MyComm the Zmodem file transfer will start automatically, and
  3932.           you will not need to use this function during Zmodem downloads.
  3933.  
  3934.  
  3935.  
  3936.  
  3937.  
  3938.  
  3939.           2.2.14 SNDBREAK()
  3940.  
  3941.           format: SNDBREAK(optional <int ms>)
  3942.  
  3943.             SNDBREAK() sends a "Break" signal for 1500 milliseconds.  It
  3944.           will also take an optional parameter for the number of
  3945.           milliseconds that the "Break" signal will be sent.
  3946.  
  3947.  
  3948.           2.2.15 ALARM()
  3949.  
  3950.           format: ALARM(optional <int ms>)
  3951.  
  3952.             ALARM() will make a noise for <int> milliseconds.  For example
  3953.           ALARM(1000) would sound a beep for one second.  The default alarm
  3954.           duration is 500 milliseconds (1/2 second).
  3955.  
  3956.  
  3957.           2.2.16 PAUSE()
  3958.  
  3959.           format: PAUSE(int seconds)
  3960.  
  3961.             PAUSE() will cause a delay for "seconds" seconds.  For example
  3962.           PAUSE(5) would pause the script for 5 seconds.
  3963.  
  3964.  
  3965.           2.2.17 HANGUP()
  3966.  
  3967.           format: HANGUP()
  3968.  
  3969.             The HANGUP() function causes the modem to disconnect.  HANGUP()
  3970.           uses the information from the MyComm configuration file to send
  3971.           the correct hang up string.
  3972.  
  3973.  
  3974.           2.2.18 IGNORECD()
  3975.  
  3976.           format: IGNORECD("Yes"|"No"|Sn)
  3977.  
  3978.             This function "Ignore Carrier Detect" tells the script
  3979.           processor to ignore the state of the "Carrier Detect" modem
  3980.           signal.  By default if the carrier signal is lost the script
  3981.           exits.  In some cases, such as while waiting for an incoming
  3982.           call, it is useful for the script to continue execution even when
  3983.           there is no carrier signal.
  3984.  
  3985.             This function takes one parameter: a string of "Yes" or "No",
  3986.           or one the string variables (S0..S9).  A value of "Yes" turns off
  3987.           carrier detect monitoring within the script, "No" turns
  3988.           monitoring back on.
  3989.  
  3990.  
  3991.  
  3992.  
  3993.  
  3994.  
  3995.           2.2.19 SETSTR()
  3996.  
  3997.           format: SETSTR(Sn, "string"|Sn)
  3998.  
  3999.           SETSTR() sets one of the string variables S0 through S9 to a
  4000.           string constant or another string variable.  For example:
  4001.  
  4002.                SETSTR(S2, "This String")
  4003.  
  4004.           would set string variable S2 to "This String".
  4005.  
  4006.             Please note that the SETSTR() function resets the "goto" label
  4007.           of the string variable if that same string variable was
  4008.           previously assigned with the IFSCAN() function.
  4009.  
  4010.           2.2.20 GOSUB()
  4011.  
  4012.           format: GOSUB("label"|Sn)
  4013.  
  4014.             The GOSUB() function is used to branch execution in the script.
  4015.           It is similar to the GOTO() function except that later in the
  4016.           script a RETURN() function may be used which will transfer script
  4017.           execution to the statement following the last GOSUB().  For
  4018.           example:
  4019.  
  4020.                GOSUB("gosub1")     ; go to label "gosub1"
  4021.                <statement1>        ; execution resumes here after RETURN()
  4022.                <statement2>
  4023.                     ...
  4024.                <statement-n>
  4025.  
  4026.                :gosub1             ; label for GOSUB() to go to
  4027.                <statement1>
  4028.                <statement2>
  4029.                     ...
  4030.                <statement-n>
  4031.                RETURN()            ; return to statement after GOSUB()
  4032.  
  4033.  
  4034.           2.2.21 RETURN()
  4035.  
  4036.           format: RETURN()
  4037.  
  4038.             The RETURN() function returns script execution to the statement
  4039.           following the most recent GOSUB().  See the description of the
  4040.           GOSUB() function above for details.
  4041.  
  4042.           2.2.22 EXIT()
  4043.  
  4044.           format: EXIT()
  4045.  
  4046.             The EXIT() function exits the script and return control back to
  4047.           MyComm.
  4048.  
  4049.  
  4050.  
  4051.  
  4052.  
  4053.  
  4054.           2.2.23 QUIT()
  4055.  
  4056.           format: QUIT()
  4057.  
  4058.             The QUIT() function exits from the script and MyComm
  4059.           completely.  Please note: QUIT() does not hang up the modem. If
  4060.           you would like the modem to disconnect the HANGUP() function
  4061.           should be used before QUIT().
  4062.  
  4063.  
  4064.           2.2.24 COMPSTR()
  4065.  
  4066.           format: COMPSTR("string"|Sn, "string"|Sn, "label"|Sn)
  4067.  
  4068.             The COMPSTR() function compares two strings or string variables
  4069.           and jumps to a label if the strings are equal.  The comparison is
  4070.           not case sensitive.
  4071.  
  4072.  
  4073.           2.2.25 LOCLECHO()
  4074.  
  4075.           format: LOCLECHO("Y"|"N")
  4076.  
  4077.             This function turns the local echo on during script execution.
  4078.           When the local echo is on anything sent with the XMIT() function
  4079.           is echoed back to the local console.  Additionally the PORTGET()
  4080.           function (see below) echoes characters back to the other system.
  4081.  
  4082.           2.2.26 IF()
  4083.  
  4084.           format: IF("TRANSTAT"|"CARDET"|"NOCARDET"|"SUCCESS", "label"|Sn)
  4085.  
  4086.             The IF() function tests one of the MyComm internal script flags
  4087.           for a TRUE condition and then jumps to a label if TRUE.  The
  4088.           internal script flags are:
  4089.  
  4090.                TRANSTAT - True if last file transfer was successful
  4091.                CARDET   - True if carrier detected
  4092.                NOCARDET - True if no carrier detected
  4093.  
  4094.  
  4095.  
  4096.  
  4097.  
  4098.  
  4099.  
  4100.           2.2.27 PORTGET()
  4101.           PORTGET()
  4102.  
  4103.           format: PORTGET(Sn, len, waittime)
  4104.  
  4105.             The PORTGET() function waits up to "waittime" seconds to get up
  4106.           to "len" characters from the COM port and put them into a string
  4107.           variable.  If the LOCLECHO() function has been activated the
  4108.           characters are echoed back to the other system.  This would be
  4109.           useful for getting responses from someone who is calling you for
  4110.           example.  Note: only printable ASCII characters in the range of
  4111.           20 hex to 7E hex (Space char through tilde) will be placed into
  4112.           the string variable.  Also note that receiving a "carriage
  4113.           return" character (0D hex) will cause PORTGET() to exit with
  4114.           whatever characters were received up to that point.
  4115.  
  4116.  
  4117.  
  4118.  
  4119.  
  4120.  
  4121.           3.0  Script Syntax Checker
  4122.  
  4123.             The program SCP_CHK.EXE is used for checking the syntax of
  4124.           script files.  To use the program to check a script file type:
  4125.  
  4126.                SCP_CHK SCRIPT.SCP
  4127.  
  4128.           Replace SCRIPT.SCP with your file name.  Also the .SCP extension
  4129.           is assumed and you may leave it off if you like.  The output from
  4130.           SCP_CHK will be display on the screen, or you may redirect the
  4131.           output to a file.  For example
  4132.  
  4133.                SCP_CHK MYSCRIPT > MYSCRIPT.OUT
  4134.  
  4135.           would create the file MYSCRIPT.OUT with all the error
  4136.           information.  This might prove useful if you have a long error
  4137.           list.
  4138.  
  4139.             The output from SCP_CHK will look something like this:
  4140.  
  4141.                Line 3  ALARM  - Error  : too few arguments
  4142.  
  4143.             This shows you the line number where the error occurred, the
  4144.           function that caused the error, and the reason why it was an
  4145.           error.  The error messages are self explanatory.  Simply re-edit
  4146.           the script file and correct any errors.  Run SCP_CHK again to
  4147.           make sure that you caught all the errors.
  4148.  
  4149.  
  4150.  
  4151.  
  4152.  
  4153.  
  4154.           4.0  Script Sample
  4155.  
  4156.             This is a sample of a working script file that picks up mail at
  4157.           a local BBS.
  4158.  
  4159.           waitfor(180, "=no change?")              ;get past opening screen
  4160.           xmit("^M")
  4161.           waitfor(30, "Do you want graphics")
  4162.           xmit("Y^M")
  4163.  
  4164.           waitfor(30, "your first name?")          ;login
  4165.           sendname()
  4166.           waitfor(30, "Is this correct?")
  4167.           xmit("Y^M)
  4168.           waitfor(30, "Password")
  4169.           sendpass()
  4170.  
  4171.           waitfor(180, "Scan Message Base")        ;get past local msgs
  4172.           xmit("N^M")
  4173.  
  4174.           waitfor(15,"Press (Enter) to continue?", jump1)
  4175.           goto("nojump1")
  4176.           :jump1
  4177.           xmit("^M")
  4178.           :nojump1
  4179.           ;at main menu now...
  4180.           waitfor(60, "Command?")
  4181.           xmit("open^M")                           ;get to door section
  4182.  
  4183.           waitfor(30, "Enter the DOOR # to Open")  ;open mail door
  4184.           xmit("3^M)
  4185.           waitfor(60, "mail Command?")
  4186.           xmit("D^M")                              ;start mail gathering
  4187.           waitfor(600, "receive these messages")
  4188.           xmit("G^M")                              ;start mail d/l
  4189.           ;zmodem will auto start here
  4190.                                                    ;download complete
  4191.           waitfor(60, "Thank you for visiting")    ;now logoff
  4192.           hangup()
  4193.           exit()                                   ;exit the script
  4194.  
  4195.  
  4196.  
  4197.  
  4198.  
  4199.  
  4200.  
  4201.           Appendix F - MyComm Order Form
  4202.  
  4203.                            MyComm Version 2.20  Order Form
  4204.                       Copyright (c) 1992 - 1994 - Ken Dorshimer
  4205.                                  All Rights Reserved
  4206.  
  4207.                                       Mail to:
  4208.                                     Ken Dorshimer
  4209.                                     P.O. Box 5143
  4210.                                  Belmont, Ca. 94002
  4211.  
  4212.  
  4213.           Your Name: _________________________________________________
  4214.  
  4215.           Address:   _________________________________________________
  4216.  
  4217.                      _________________________________________________
  4218.  
  4219.           City:      _________________________________________________
  4220.  
  4221.  
  4222.           State:    _________      Zip Code: _________________________
  4223.  
  4224.           Disk Format: 5.25" floppy ____   OR  3.5" semi-floppy ____
  4225.  
  4226.  
  4227.           Number of Copies of MyComm  _______  X $25.00 =   __________
  4228.  
  4229.           Number of Copies of MyComm  _______  X $2 S&H = + __________
  4230.  
  4231.                                                 Total:      __________
  4232.  
  4233.  
  4234.           Please make check or Money Order payable to Ken Dorshimer, and
  4235.           send to the address above (mine not yours).
  4236.  
  4237.           Funds should be in U.S dollars, and drawn on a U.S. bank.
  4238.  
  4239.             (Please send check or money order, do not send cash.  People
  4240.           who want to order MyComm from outside the U.S. should obtain a
  4241.           money order in U.S. dollars from a local bank).
  4242.  
  4243.             Please note: I am not able to process credit card orders at
  4244.           this time (several folks have asked me about this).
  4245.  
  4246.  
  4247.  
  4248.  
  4249.  
  4250.  
  4251.           Appendix G - MyComm Bug Report Form
  4252.  
  4253.                         MyComm Version 2.20  Bug Report Form
  4254.  
  4255.             This form may be used to describe any problems, or bugs that
  4256.           you may have found with MyComm.  You may also use it to describe
  4257.           any enhancements you would like to see added to MyComm, or
  4258.           suggestions for future versions.
  4259.  
  4260.             Bug reports and suggestions are always welcome.  Of course all
  4261.           bug reports and suggestions get much closer scrutiny when
  4262.           accompanied by a registration check <grin>.
  4263.  
  4264.           ----------------------------------------------------------
  4265.  
  4266.           Machine Type __________________________     DOS Version ____
  4267.  
  4268.           Machine BIOS Type _____________________     Monitor ________
  4269.  
  4270.           Modem Brand __________________________      Speed     ______
  4271.  
  4272.           Describe problem, bug, or suggestion:
  4273.  
  4274.           ____________________________________________________________
  4275.           ____________________________________________________________
  4276.           ____________________________________________________________
  4277.           ____________________________________________________________
  4278.           ____________________________________________________________
  4279.           ____________________________________________________________
  4280.           ____________________________________________________________
  4281.           ____________________________________________________________
  4282.           ____________________________________________________________
  4283.           ____________________________________________________________
  4284.           ____________________________________________________________
  4285.           ____________________________________________________________
  4286.           ____________________________________________________________
  4287.           ____________________________________________________________
  4288.           ____________________________________________________________
  4289.           ____________________________________________________________
  4290.           ____________________________________________________________
  4291.           ____________________________________________________________
  4292.           ____________________________________________________________
  4293.           ____________________________________________________________
  4294.  
  4295.  
  4296.                                       Mail To:
  4297.                                     Ken Dorshimer
  4298.                                     P.O. Box 5143
  4299.                                  Belmont, Ca. 94002
  4300.  
  4301.  
  4302.  
  4303.  
  4304.  
  4305.  
  4306.           Appendix H - Planned Modifications and Upgrades
  4307.  
  4308.             At this time I am planning (contingent on the number of
  4309.           registrations of MyComm) to make several modifications and
  4310.           upgrades to MyComm.  Some of these are:
  4311.  
  4312.  
  4313.                  ■  MS-Windows (Tm) and/or Deskview (Tm)
  4314.                     compatibility
  4315.  
  4316.                  ■  Compuserve-B file transfer protocol
  4317.  
  4318.                  ■  VT-200 Terminal Emulation (as well as some other ones
  4319.                     people have been asking about)
  4320.  
  4321.                  ■  Script Language enhancements
  4322.  
  4323.             Of course upgrades are dependent on you, the end user.  MyComm
  4324.           is user supported software.  If I see that people are interested
  4325.           in the program, and interested enough to register it, I will feel
  4326.           more inclined to continue to perform upgrades to MyComm.
  4327.  
  4328.             The creation and development of a program like MyComm is by no
  4329.           means trivial.  Continued user support in the form of
  4330.           registrations gives me, your humble author, the incentive to keep
  4331.           upgrading and improving MyComm.
  4332.  
  4333.  
  4334.  
  4335.  
  4336.  
  4337.  
  4338.           Appendix I - MyComm Revision History
  4339.  
  4340.           Note: Past versions of this section had every nuance of every
  4341.           enhancement or bug fix listed.  I have decided to only list the
  4342.           enhancements that pertain to the current major release for
  4343.           brevity.
  4344.  
  4345.           September 19, 1991  - MyComm Version 1.0 design began
  4346.           February 16, 1992   - MyComm Version 1.0 completed
  4347.           March 18, 1992      - MyComm Version 1.10 completed
  4348.           April 11, 1992      - MyComm Version 1.20 completed
  4349.           May 9, 1992         - MyComm Version 1.22 completed
  4350.           April 8, 1993       - MyComm Version 2.0 (Major revision)
  4351.           June 19, 1993       - MyComm Version 2.01 (Bug fix)
  4352.           July 7, 1993        - MyComm Version 2.02 (Bug fix)
  4353.           August 8, 1993      - MyComm Version 2.1 (Enhancement)
  4354.           November 11, 1993   - MyComm Version 2.11 (Maintenance release)
  4355.           Nov. 93 - Jan 94    - MyComm Versions 2.12 - 2.14
  4356.                                 were "registered" releases only
  4357.           January 3, 1994     - MyComm Version 2.15 (Enhancement)
  4358.           March 28, 1994      - MyComm Version 2.20 (Enhancement)
  4359.                                   - Fixed some minor bugs and annoyances
  4360.                                   - Enhanced script language
  4361.                                   - Included Host Mode script
  4362.                                   - Kermit protocol added
  4363.  
  4364.  
  4365.  
  4366.  
  4367.  
  4368.  
  4369.           Appendix J - Control Characters
  4370.  
  4371.             MyComm supports the sending of standard data communications
  4372.           control characters.  Control characters are preceded by the caret
  4373.           character '^'.  The caret denotes that the next character will be
  4374.           a control character.  For example ^M is the symbol for Carriage
  4375.           Return or <Enter> which could be used to terminate your "Modem
  4376.           Initialization String".  The '^' stands for Ctrl, so sending one
  4377.           of these sequences would be similar to pressing the <Ctrl> key
  4378.           and the character 'M' simultaneously.  The control characters are
  4379.           especially useful when using the script language functions. For
  4380.           example ^[  represents the ESCape character which is often used
  4381.           to start a session on a BBS.
  4382.  
  4383.            Please note that these control sequences are only interpreted by
  4384.           MyComm when you are sending a string such as your "Modem
  4385.           Initialization String", "Hangup String", etc. or with the XMIT()
  4386.           function in the script language.  A listing of commonly used
  4387.           control characters follows.
  4388.  
  4389.           Sequence       Meaning
  4390.  
  4391.           ^@             NUL
  4392.           ^A             SOH
  4393.           ^B             STX
  4394.           ^C             ETX
  4395.           ^D             EOT
  4396.           ^E             ENQuire
  4397.           ^F             ACKnowledge
  4398.           ^G             BELL
  4399.           ^H             BackSpace
  4400.           ^I             TAB
  4401.           ^J             Line Feed
  4402.           ^L             Form Feed
  4403.           ^M             Carriage Return (Enter key)
  4404.           ^P             DLE
  4405.           ^Q             XON
  4406.           ^S             XOFF
  4407.           ^U             NAK
  4408.           ^V             SYN
  4409.           ^X             CANcel (often used for aborting file transfers)
  4410.           ^Z             SUB (also end of file)
  4411.           ^[             ESCape
  4412.  
  4413.  
  4414.  
  4415.  
  4416.  
  4417.  
  4418.  
  4419.           -D (Dial Command Line Parameter)  12
  4420.           -J (Join Script Command Line Parameter)  12
  4421.           -T (Timed Start Command Line Parameter)  13
  4422.           1K-Xmodem File Transfers  54
  4423.           3270 Terminal Emulation  62
  4424.           Add LF after incoming CR  22
  4425.           Add Phone List Item  17
  4426.           ALARM()  73
  4427.           Alt A  15
  4428.           Alt B  16
  4429.           Alt C  16
  4430.           Alt D  16
  4431.           Alt E  26
  4432.           Alt H  26
  4433.           Alt I  26
  4434.           Alt K  28
  4435.           Alt L  27
  4436.           Alt M  28
  4437.           Alt O  28
  4438.           Alt P  29
  4439.           Alt Q  29
  4440.           Alt R  29
  4441.           Alt S  30
  4442.           Alt T  30
  4443.           Alt U  30
  4444.           Alt W  48
  4445.           Alt X  48
  4446.           ANSI Terminal Emulation  60
  4447.           ASCII File Transfers  53
  4448.           ASCII Transfers Setup  38
  4449.           ASCII Transfers Setup Screen  39
  4450.           Baud Rate  18
  4451.           BS Key Sends BS or DELete  21
  4452.           Bug Report Form  80
  4453.           Call Numbers (Dial)  22
  4454.           Caret Sign  83
  4455.           Change Port Parameters - Alt P  29
  4456.           Change Port Parameters Screen  29
  4457.           Character Pace Time  40
  4458.           Chat Mode - Alt A  15
  4459.           CHDIR()  76
  4460.           Clear last date called  22
  4461.           Clear the Screen - Alt C  16
  4462.           Clever quip for TagLine  47
  4463.           COM Port  32
  4464.           COM Port Addresses  47
  4465.           Command Line Parameters  12
  4466.           Command Summary  58
  4467.           COMPSTR()  75
  4468.           Connect Strings  36
  4469.           CONSCLR()  76
  4470.           CONSGET()  76
  4471.           CONSLOC()  76
  4472.  
  4473.  
  4474.  
  4475.  
  4476.  
  4477.  
  4478.           CONSMGET()  76
  4479.           CONSMSG()  76
  4480.           Control Characters  83
  4481.           CR Translation Upload and Download  39
  4482.           Data Bits  19
  4483.           Data Parity  19
  4484.           Date Format Style  45
  4485.           DECFLAG()  70
  4486.           Default Protocol  19
  4487.           Definitions, Acronyms  5
  4488.           Delete an Item  22
  4489.           Dial Entries  12
  4490.           Dial Prefix  19
  4491.           Dial Screen  17
  4492.           DIAL()  76
  4493.           Dialing Functions - Alt D  16
  4494.           Dialing Prefix #1  35
  4495.           Dialing Prefix #2  35
  4496.           Dialing Prefix #3  35
  4497.           Dialing Prefixes  35
  4498.           Dialing Status Window  23
  4499.           Dialing Wait Time  34
  4500.           Disclaimer and Warranty  5
  4501.           Download Directory Path  37
  4502.           Download Files - PgDn  53
  4503.           Download Protocol Menu  51
  4504.           Download/Upload Status Window  51
  4505.           Edit Phone List Item Screen  17, 18
  4506.           Editor Path\Filename  38
  4507.           Exit MyComm - Alt X  48
  4508.           EXIT()  74
  4509.           Expand Blank Lines to Spaces  40
  4510.           External Programs Path\Filename  38
  4511.           External Protocol File Transfers  56
  4512.           External Protocols Setup  43
  4513.           External Protocols Setup Screen  43
  4514.           F1 key  15, 48
  4515.           F2 key  49
  4516.           F3 key  49
  4517.           F4 key  49
  4518.           File Transfer Hints  53
  4519.           FILEHERE()  76
  4520.           Filename Guessing  47
  4521.           Find Phone List Items  25
  4522.           General System Requirements  6
  4523.           GOSUB()  74
  4524.           GOTO()  69
  4525.           Guess Filename  47
  4526.           Guess Up/Download Filename  47
  4527.           Hang Up Modem - Alt H  26
  4528.           HANGUP()  73
  4529.           Help Menu - F1  15
  4530.           Help Screen  15
  4531.           Help Screen - F1  48
  4532.  
  4533.  
  4534.  
  4535.  
  4536.  
  4537.  
  4538.           High speed modem  32
  4539.           IF()  75
  4540.           IFFLAG()  70
  4541.           IFSCAN()  70
  4542.           Ignore Carrier Detect  73
  4543.           IGNORECD()  73
  4544.           INCFLAG()  70
  4545.           Installation  8, 9
  4546.           Introduction to MyComm  1
  4547.           Join Script  12
  4548.           Join Script - Alt J  27
  4549.           JUMPSCP()  76
  4550.           KBDFLSH()  76
  4551.           Kermit File Transfers  56
  4552.           Kermit Transfers Setup  42
  4553.           LF Translation Upload and Download  40
  4554.           Line Editing Functions  59
  4555.           Line Pace Time  40
  4556.           Load Phone List Screen  25
  4557.           Local Echo  21
  4558.           Local Echo on by Default  34
  4559.           Local Echo On During ASCII Uploads  40
  4560.           Local Echo On/Off - Alt E  26
  4561.           LOCLECHO()  75
  4562.           Logon Name  20
  4563.           Make Noise After File Transfers  46
  4564.           Make Noise When Calls Connect  46
  4565.           Manual Dial - Alt M  28
  4566.           Manual Dial Screen  24
  4567.           Manual Dial Window  24
  4568.           Mark Phone List Items  24
  4569.           Miscellaneous Options Setup  44
  4570.           Miscellaneous Options Setup Screen  45
  4571.           Modem Answer String  33
  4572.           Modem Attention String  33
  4573.           Modem Cancel Dial String  33
  4574.           Modem Dial Suffix String  33
  4575.           Modem Hang Up String  33
  4576.           Modem Initialization String  32
  4577.           Modem Setup Screen  31
  4578.           Move Phone List Item  25
  4579.           MyComm as a Host  56
  4580.           MyComm Bug Report Form  80
  4581.           MyComm Command Summary  58
  4582.           MyComm Files  7
  4583.           MyComm Installation  8
  4584.           MyComm Line Editing Functions  59
  4585.           MyComm Order Form  79
  4586.           MyComm Registration and Licensing  2
  4587.           MyComm Revision History  82
  4588.           MyComm Screens and Menus  13
  4589.           Name  18
  4590.           Number  18
  4591.           Order Form  79
  4592.  
  4593.  
  4594.  
  4595.  
  4596.  
  4597.  
  4598.           Outside to DOS - Alt O  28
  4599.           Pacing Char  41
  4600.           Page Down  53
  4601.           Page Up  53
  4602.           Password  20
  4603.           Password for sign on  46
  4604.           Paths Setup  36
  4605.           Paths Setup Screen  37
  4606.           Pause Between Calls  34
  4607.           PAUSE()  73
  4608.           PgDn  53
  4609.           PgUp  53
  4610.           Phone File Path\File  38
  4611.           Phone Item Info Screen  23, 24
  4612.           Planned Modifications and Upgrades  81
  4613.           PORTFLSH()  76
  4614.           PORTGET()  76
  4615.           Present Line Status - Alt L  27
  4616.           Present Line Status Window  27
  4617.           Print Phone List  26
  4618.           Protocols Setup  38
  4619.           Protocols Setup Menu  38
  4620.           Quick Re-Dial - Alt Q  29
  4621.           QUIT()  75
  4622.           Received BS (BackSpace) Destructive  21
  4623.           RECVFILE()  72
  4624.           Remote Abort Char  39
  4625.           Restore to Defaults  48
  4626.           RETURN()  74
  4627.           Revision History  82
  4628.           Run External Program - Alt R  29
  4629.           RUNDOS()  76
  4630.           Save Changes  22
  4631.           Save Setup  48
  4632.           SCP Files  67
  4633.           SCP_CHK.EXE  77
  4634.           Screen Background Color  45
  4635.           Screen Capture Path\File  37
  4636.           Screen Text Color  45
  4637.           Screens and Menus  13
  4638.           Script - Dialing Entry  22
  4639.           Script, creating  66
  4640.           Script Labels  68
  4641.           Script Language  66, 67
  4642.           Script Sample  78
  4643.           Script Syntax Checker  77
  4644.           Scripts, Special Characters  68
  4645.           Scroll Back - Alt K  28
  4646.           SEAlink Derived File Transfers  54
  4647.           Send Break - Alt B  16
  4648.           Send Init. String Menu  27
  4649.           Send Modem Initialization Strings - Alt I  26
  4650.           Send Name - F2  49
  4651.           Send Password - F3  49
  4652.  
  4653.  
  4654.  
  4655.  
  4656.  
  4657.  
  4658.           Send Screen to File - Alt W  48
  4659.           Send Tagline  - F4  49
  4660.           SENDFILE()  71
  4661.           SENDNAME()  71
  4662.           SENDPASS()  71
  4663.           SESCAP()  76
  4664.           Session Capture On/Off/Pause - Alt S  30
  4665.           Session Capture Path\File  37
  4666.           SETFLAG()  69
  4667.           SETSTR()  74
  4668.           SNDBREAK()  73
  4669.           Sort Phone List  25
  4670.           Starting a File Transfer  50
  4671.           Stop Bits  19
  4672.           Strip Hi Bits  21
  4673.           Strip High Bits  39
  4674.           System Requirements  8
  4675.           Terminal Emulation - Alt T  30
  4676.           Terminal Screen  14
  4677.           Terminal Type  20
  4678.           Time Format - 12 or 24 Hour  45
  4679.           Timed Start  13
  4680.           Transferring Files  49
  4681.           Troubleshooting  63
  4682.           TTY Terminal Emulation  60
  4683.           Update Configuration - Alt U  30
  4684.           Update Configuration Menu  31
  4685.           Upload Directory Path  37
  4686.           UpLoad Files - PgUp  53
  4687.           Use CTS/RTS Flow Control  35
  4688.           Use Direct Video  46
  4689.           Use DSR/DTR Flow Control  35
  4690.           Use DTR to Hang Up Modem  34
  4691.           Use XON/XOFF Flow Control  35
  4692.           VT-100 Terminal Emulation  61
  4693.           VT-52 Terminal Emulation  61
  4694.           WAITFOR()  69
  4695.           XMIT()  69
  4696.           Xmodem File Transfers  54
  4697.           Xmodem-1K  54
  4698.           Ymodem  54
  4699.           Ymodem Batch - 1K  55
  4700.           Ymodem Batch File Transfers  55
  4701.           Ymodem-G Batch  55
  4702.           Your Name for sign on  46
  4703.           Zmodem 32 Bit CRC  41
  4704.           Zmodem Auto Download Feature  41
  4705.           Zmodem File Transfers  55
  4706.           Zmodem Receive Crash Recovery  42
  4707.           Zmodem Send Crash Recovery  41
  4708.           Zmodem Transfers Setup  41